How do I install the Backlog API skill?

Run npx skillmds@latest add tsubakimoto/backlog-api in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Backlog API safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Backlog API?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Backlog API free to use?

Yes. Installing skills from SkillMD is free. This skill is licensed under Proprietary.

Who published Backlog API?

tsubakimoto (@tsubakimoto) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Backlog API by tsubakimoto — Agent Skill

Name: Backlog API
Author: tsubakimoto

Backlog API

Backlog（ヌーラボ社のプロジェクト管理SaaS）のREST API v2に関するエキスパートスキル。課題の作成・検索・更新、プロジェクト管理、Wiki操作、Git/プルリクエスト、通知、チーム管理などBacklog APIを使ったコード生成や自動化を支援する。Backlog APIの認証方式、エンドポイント、パラメータ、エラーハンドリングについて質問されたとき、またはBacklog連携スクリプトやアプリを構築するときに使用する。

tsubakimoto f143599 3 files · 130.9 KB Updated Sep 17, 2026

File contents

Backlog API Expert

Backlog API v2 を使った開発を支援するスキル。

API概要

ベースURL: https://{スペースID}.backlog.com/api/v2 または https://{スペースID}.backlog.jp/api/v2
形式: REST API（JSON）
公式ドキュメント: https://developer.nulab.com/ja/docs/backlog/
詳細なAPI仕様: references/backlog-v2-openapi.yml を参照

前提条件

Backlogスペースへのアクセス権
API Key（スペースの「個人設定」>「API」から発行）または OAuth 2.0 アクセストークン
.NET 10 SDK 以降（C# file-based app 実行用）

認証

API Key認証（クエリパラメータ）

GET /api/v2/space?apiKey=YOUR_API_KEY

OAuth 2.0（Authorizationヘッダー）

Authorization: Bearer YOUR_ACCESS_TOKEN

APIカテゴリ

カテゴリ	ベースパス	主な操作
スペース	`/space`	情報取得、お知らせ、容量、添付ファイル送信
ユーザー	`/users`	CRUD、認証ユーザー情報、活動履歴、スター
チーム	`/teams`	CRUD、アイコン（`/groups` は非推奨）
プロジェクト	`/projects`	CRUD、状態・種別・カスタム属性、Webhook
課題	`/issues`	CRUD、検索、コメント、添付ファイル
Wiki	`/wikis`	CRUD、タグ、添付ファイル、更新履歴
Git	`/projects/.../git/repositories`	リポジトリ、プルリクエスト
お知らせ	`/notifications`	一覧取得、既読化
マスターデータ	`/priorities`, `/resolutions`	優先度・完了理由一覧

各エンドポイントの詳細パラメータは references/backlog-v2-openapi.yml を参照。

課題検索パラメータ（`GET /issues`）

パラメータ	説明
`projectId[]`	プロジェクトID（複数指定可）
`statusId[]`	状態ID（複数指定可）
`assigneeId[]`	担当者ID（複数指定可）
`issueTypeId[]`	種別ID（複数指定可）
`keyword`	検索キーワード
`sort`	ソート属性（`created`, `updated`, `dueDate` 等）
`order`	`asc` / `desc`（デフォルト `desc`）
`count`	取得上限 1-100（デフォルト 20）
`offset`	オフセット
`createdSince` / `createdUntil`	登録日範囲 (yyyy-MM-dd)
`parentChild`	0:すべて, 1:子課題以外, 2:子課題, 4:親課題

共通パターン

ページネーション

count（1-100）と offset を組み合わせる

複数値パラメータ

statusId[]=1&statusId[]=2

ID指定方式

{issueIdOrKey}: 数値ID または課題キー（例: PROJECT-123）
{projectIdOrKey}: 数値ID またはプロジェクトキー（例: PROJECT）

C#スクリプト

基本的な操作は C# file-based app の scripts/backlog_api.cs を実行または参照する。

# 実行例
dotnet run --file scripts\backlog_api.cs -- --space myspace --api-key YOUR_KEY get-issues --project-id 12345

---name: backlog-apidescription: Backlog（ヌーラボ社のプロジェクト管理SaaS）のREST API v2に関するエキスパートスキル。課題の作成・検索・更新、プロジェクト管理、Wiki操作、Git/プルリクエスト、通知、チーム管理などBacklog APIを使ったコード生成や自動化を支援する。Backlog APIの認証方式、エンドポイント、パラメータ、エラーハンドリングについて質問されたとき、またはBacklog連携スクリプトやアプリを構築するときに使用する。license: Proprietary. LICENSE has complete terms.---# Backlog API ExpertBacklog API v2 を使った開発を支援するスキル。## API概要- **ベースURL**: `https://{スペースID}.backlog.com/api/v2` または `https://{スペースID}.backlog.jp/api/v2`- **形式**: REST API（JSON）- **公式ドキュメント**: https://developer.nulab.com/ja/docs/backlog/- **詳細なAPI仕様**: [references/backlog-v2-openapi.yml](./references/backlog-v2-openapi.yml) を参照## 前提条件- Backlogスペースへのアクセス権- API Key（スペースの「個人設定」>「API」から発行）または OAuth 2.0 アクセストークン- .NET 10 SDK 以降（C# file-based app 実行用）## 認証### API Key認証（クエリパラメータ）```GET /api/v2/space?apiKey=YOUR_API_KEY```### OAuth 2.0（Authorizationヘッダー）```Authorization: Bearer YOUR_ACCESS_TOKEN```## APIカテゴリ| カテゴリ | ベースパス | 主な操作 ||---------|-----------|---------|| スペース | `/space` | 情報取得、お知らせ、容量、添付ファイル送信 || ユーザー | `/users` | CRUD、認証ユーザー情報、活動履歴、スター || チーム | `/teams` | CRUD、アイコン（`/groups` は非推奨） || プロジェクト | `/projects` | CRUD、状態・種別・カスタム属性、Webhook || 課題 | `/issues` | CRUD、検索、コメント、添付ファイル || Wiki | `/wikis` | CRUD、タグ、添付ファイル、更新履歴 || Git | `/projects/.../git/repositories` | リポジトリ、プルリクエスト || お知らせ | `/notifications` | 一覧取得、既読化 || マスターデータ | `/priorities`, `/resolutions` | 優先度・完了理由一覧 |各エンドポイントの詳細パラメータは [references/backlog-v2-openapi.yml](./references/backlog-v2-openapi.yml) を参照。## 課題検索パラメータ（`GET /issues`）| パラメータ | 説明 ||-----------|------|| `projectId[]` | プロジェクトID（複数指定可） || `statusId[]` | 状態ID（複数指定可） || `assigneeId[]` | 担当者ID（複数指定可） || `issueTypeId[]` | 種別ID（複数指定可） || `keyword` | 検索キーワード || `sort` | ソート属性（`created`, `updated`, `dueDate` 等） || `order` | `asc` / `desc`（デフォルト `desc`） || `count` | 取得上限 1-100（デフォルト 20） || `offset` | オフセット || `createdSince` / `createdUntil` | 登録日範囲 (yyyy-MM-dd) || `parentChild` | 0:すべて, 1:子課題以外, 2:子課題, 4:親課題 |## 共通パターン### ページネーション- `count`（1-100）と `offset` を組み合わせる### 複数値パラメータ```statusId[]=1&statusId[]=2```### ID指定方式- `{issueIdOrKey}`: 数値ID または課題キー（例: `PROJECT-123`）- `{projectIdOrKey}`: 数値ID またはプロジェクトキー（例: `PROJECT`）## C#スクリプト基本的な操作は C# file-based app の [scripts/backlog_api.cs](./scripts/backlog_api.cs) を実行または参照する。```bash# 実行例dotnet run --file scripts\backlog_api.cs -- --space myspace --api-key YOUR_KEY get-issues --project-id 12345```

Frequently asked questions