This is the reference for the Focus REST API. The REST API enables you to interact with Focus programmatically. Use this API for scripting interactions with Focus and sending data from external tools. This page documents the REST resources available in Focus, including the HTTP response codes and example requests and responses.

This documentation is for version 1 of the Focus REST API.

Focus REST API v1 resources are available through the following gateway paths:

• https://your-domain.atlassian.net/gateway/api/focus/v1/focus-areas
• https://api.atlassian.com/focus/cloud/{cloudId}/v1/focus-areas

Use the first path for site-domain access. Use the second path for cloud-id based access.

The Focus REST API supports the following authentication methods:

Atlassian API token (Basic auth)

Use this method when calling through your Atlassian site domain and gateway path:

1
2
curl --request GET \
  --url 'https://your-domain.atlassian.net/gateway/api/focus/v1/focus-areas' \
  --user 'email@example.com:<api_token>' \
  --header 'Accept: application/json'

OAuth 2.0 bearer token

Use this method with an OAuth 2.0 access token in the Authorization header:

1
2
curl --request GET \
  --url 'https://api.atlassian.com/focus/cloud/<cloud_id>/v1/focus-areas' \
  --header 'Authorization: Bearer <access_token>' \
  --header 'Accept: application/json'

Atlassian session authentication

Browser-based requests from authenticated Atlassian sessions are also supported on site-domain gateway paths. OAuth 2.0 scopes used by this API include:

• focus-areas-read-scope for read operations
• focus-areas-write-scope for write operations

Generate an API token (Basic auth method)

API token authentication uses HTTP Basic auth with your Atlassian account email and API token.

1. Generate an API token for your Atlassian account: https://id.atlassian.com/manage/api-tokens
2. Use email@example.com:<api_token> with Basic auth (for example via --user in cURL), or build the equivalent Authorization: Basic ... header.

Authorization is enforced based on the authenticated principal and granted scopes/permissions for the requested operation. For OAuth 2.0 and API token calls through api.atlassian.com, access is evaluated against the target cloud site (cloudId).

The Focus REST API uses the standard HTTP status codes.

Responses that return an error status code also return a response body, similar to this:

1
2
{
  "errors": [
    {
      "type": "FORMAT_INVALID",
      "message": "Field [name] is invalid."
    }
  ]
}