bee api

Overview

Make an authenticated API request

The endpoint is a Backlog API path (e.g. users/myself). A leading /api/v2/ prefix is stripped automatically.

-f infers types (number, boolean, string); -F always sends strings. Repeated keys become arrays. Append [] for a single-element array (e.g. -f projectId[]=12345).

For GET, fields are query parameters. For POST/PUT/PATCH/DELETE, fields are the request body.

Usage

bee api [flags] <ENDPOINT>

Arguments

ENDPOINT

API endpoint path

Flags

-X , --method <method>

HTTP method (default: GET)

-f , --field <key=value>

Add a parameter with type inference (key=value, repeatable)

-F , --raw-field <key=value>

Add a string parameter (key=value, repeatable)

--json <fields>

Output as JSON (optionally filter by field names, comma-separated)

--silent

Do not print the response body

-s , --space <hostname>

Space hostname

Examples

Get your user profile

bee api users/myself

List issues in a project

bee api issues -f 'projectId[]=12345' -f count=5

Filter by multiple statuses

bee api issues -f 'projectId[]=12345' -f statusId=1 -f statusId=2

Create an issue

bee api issues -X POST -f projectId=12345 -f summary="Test issue" -f issueTypeId=1 -f priorityId=3

Select specific fields

bee api users/myself --json id,name,mailAddress

Environment variables

BACKLOG_SPACE

Space hostname

BACKLOG_API_KEY

Authenticate with an API key