GET

Get Forge App attachment

Get a file attached to a component. If you need to have attachment upload enabled for your Compass Forge app, contact Atlassian support.

Request

Path parameters

componentId

string

Required
forgeAppId

string

Required
key

string

Required

Responses

Returned if the file exists.

application/json

Attachment
GET/compass/v1/component/{componentId}/app/{forgeAppId}/attachment/{key}
1 2 3 4 curl --request GET \ --url 'https://your-domain.atlassian.net/gateway/api/compass/v1/component/{componentId}/app/{forgeAppId}/attachment/{key}' \ --user 'email@example.com:<api_token>' \ --header 'Accept: application/json'
200Response
1 2 3 4 5 { "name": "<string>", "url": "<string>", "lastModifiedAt": "<string>" }
PUT

Upload Forge App attachment

Attach a file to a component. If you need to have attachment upload enabled for your Compass Forge app, contact Atlassian support.

Request

Path parameters

componentId

string

Required
forgeAppId

string

Required
key

string

Required

Request bodymultipart/form-data application/json

file

string

Required

Responses

Returned if the file upload is successful.

application/json

Attachment
PUT/compass/v1/component/{componentId}/app/{forgeAppId}/attachment/{key}
1 2 3 4 5 6 7 8 curl --request PUT \ --url 'https://your-domain.atlassian.net/gateway/api/compass/v1/component/{componentId}/app/{forgeAppId}/attachment/{key}' \ --user 'email@example.com:<api_token>' \ --header 'Accept: application/json' \ --header 'Content-Type: application/json' \ --data '{ "file": "<string>" }'
200Response
1 2 3 4 5 { "name": "<string>", "url": "<string>", "lastModifiedAt": "<string>" }
DEL

Delete Forge App attachment

Delete file attached to a component. If you need to have attachment upload enabled for your Compass Forge app, contact Atlassian support.

Request

Path parameters

componentId

string

Required
forgeAppId

string

Required
key

string

Required

Responses

Returned if the file delete is successful.

DEL/compass/v1/component/{componentId}/app/{forgeAppId}/attachment/{key}
1 2 3 curl --request DELETE \ --url 'https://your-domain.atlassian.net/gateway/api/compass/v1/component/{componentId}/app/{forgeAppId}/attachment/{key}' \ --user 'email@example.com:<api_token>'
PUT

Upload Component API Spec

Add/Update api specs for a component.

Request

Path parameters

componentId

string

Required

Request bodymultipart/form-data application/json

file

string

Required

Responses

Returned if the file upload is successful.

application/json

string

PUT/compass/v1/component/{componentId}/api_specs
1 2 3 4 5 6 7 8 curl --request PUT \ --url 'https://your-domain.atlassian.net/gateway/api/compass/v1/component/{componentId}/api_specs' \ --user 'email@example.com:<api_token>' \ --header 'Accept: application/json' \ --header 'Content-Type: application/json' \ --data '{ "file": "<string>" }'
200Response
1 "<string>"
POST

An invocation of an inbound webhook

Third parties can call these inbound webhooks to dothings within compass, like create deployment events for webhooks coming from github

Request

Path parameters

webhookId

string

Required

Request bodyapplication/json

string

Responses

Returned if the process of invoking a webhook with a payload has been enqueud.

POST/compass/v1/webhooks/{webhookId}
1 2 3 4 5 curl --request POST \ --url 'https://your-domain.atlassian.net/gateway/api/compass/v1/webhooks/{webhookId}' \ --user 'email@example.com:<api_token>' \ --header 'Content-Type: application/json' \ --data '"<string>"'
POST

Post compass v1 fct

Request

Request bodyapplication/json

contextIds

array<string>

Required
extensionData

object

Required
extensionId

string

Required
extensionKey

string

Required
appVersion

string

Required

Responses

OK

application/json

ForgeContextTokenResponse
POST/compass/v1/fct
1 2 3 4 5 6 7 8 9 10 11 12 13 14 curl --request POST \ --url 'https://your-domain.atlassian.net/gateway/api/compass/v1/fct' \ --user 'email@example.com:<api_token>' \ --header 'Accept: application/json' \ --header 'Content-Type: application/json' \ --data '{ "contextIds": [ "<string>" ], "extensionData": {}, "extensionId": "<string>", "extensionKey": "<string>", "appVersion": "<string>" }'
200Response
1 2 3 4 5 6 7 8 9 { "extensionId": "<string>", "jwt": "<string>", "expiresAt": 2154, "success": true, "errors": [ "<string>" ] }
POST

Get Entitlement Results

Get entitlement results for a given user and site

Request

Request bodyapplication/json

entitlements

array<string>

Required

Responses

Returned if the file upload is successful.

application/json

EntitlementResponseDto
POST/compass/v1/entitlements
1 2 3 4 5 6 7 8 9 10 curl --request POST \ --url 'https://your-domain.atlassian.net/gateway/api/compass/v1/entitlements' \ --user 'email@example.com:<api_token>' \ --header 'Accept: application/json' \ --header 'Content-Type: application/json' \ --data '{ "entitlements": [ "<string>" ] }'
200Response
1 2 3 { "entitlements": {} }

Rate this page: