Skip to content

Your workspace, with its entitlement and support access

GET
/v1/buyer/workspace
curl --request GET \
--url https://example.com/v1/buyer/workspace \
--header 'Authorization: Bearer <token>'

Who: a workspace’s member, staff under its support access, or its key. Not for API keys.

OK

Media typeapplication/json
object
support_access
required
Any of:
object
expires_at
required
string format: date-time
granted_at
required
string format: date-time
granted_by
required
Any of:
object
account
string
id
string
kind
required
string | null
Allowed values: user api_key service system postback rule tuner schedule
name
string
note
required
string
revoked_at
required
string | null format: date-time
revoked_by
required
Any of:
object
account
string
id
string
kind
required
string | null
Allowed values: user api_key service system postback rule tuner schedule
name
string
workspace_id
required
integer format: int64
workspace
required
object
created_at
required
string format: date-time
created_by
required
Any of:
object
account
string
id
string
kind
required
string | null
Allowed values: user api_key service system postback rule tuner schedule
name
string
entitlement
required
object
ends_at
required
string | null format: date-time
hold
required
string | null
Allowed values: staff billing expired
limits
required
object
connections
required
integer format: int32
custom_domains
required
integer format: int32
members
required
integer format: int32
private_templates
required
boolean
retention
string
Allowed values: days_90 days_180 days_400
visits_per_month
required
integer format: int64
plan
required
string
product
required
string | null
Allowed values: buyer_tracker
source
required
string | null
Allowed values: grant billing
starts_at
required
string | null format: date-time
status
required
string | null
Allowed values: active suspended ended pending
status_reason
required
string
suspended_at
required
string | null format: date-time
updated_at
required
string | null format: date-time
updated_by
required
Any of:
object
account
string
id
string
kind
required
string | null
Allowed values: user api_key service system postback rule tuner schedule
name
string
id
required
integer format: int64
name
required
string
sequence
required
integer format: int64
slug
required
string
updated_at
required
string format: date-time

Example

{
"support_access": {
"granted_by": {
"kind": "user"
},
"revoked_by": {
"kind": "user"
}
},
"workspace": {
"created_by": {
"kind": "user"
},
"entitlement": {
"hold": "staff",
"limits": {
"retention": "days_90"
},
"product": "buyer_tracker",
"source": "grant",
"status": "active",
"updated_by": {
"kind": "user"
}
}
}
}

An error, as go-commons apperr maps it

Media typeapplication/json
object
error
required
object
code
required
string
fields
object
key
additional properties
string
message
required
string

Example generated

{
"error": {
"code": "example",
"fields": {
"additionalProperty": "example"
},
"message": "example"
}
}