agency
Open an operation to see its authentication, its parameters and the fields of its request and response.
11 operations
GET/v1/agency/clients/{id}
One client: its card, service levels, report settings and consent.
/v1/agency/clients/{id}Authentication: Dashboard session
Parameters
| Name | Type | Description |
|---|---|---|
idpathrequired | string | |
periodquery | string |
Response 200
| Name | Type | Description |
|---|---|---|
cardrequired | object | |
card.workspace_idrequired | string | |
card.workspace_namerequired | string | |
card.client_namerequired | string | |
card.slugrequired | string | |
card.open_ticketsrequired | integer | |
card.awaiting_approvalrequired | integer | |
card.escalationsrequired | integer | |
card.sla_breachedrequired | integer | |
card.tickets_receivedrequired | integer | |
card.tickets_resolvedrequired | integer | |
card.median_first_response_minutesrequired | number | |
card.median_release_minutesrequired | number | |
card.proactive_fixesrequired | integer | |
card.last_releaserequired | object | |
card.last_release.idrequired | string | |
card.last_release.versionrequired | string | |
card.last_release.tagrequired | string | |
card.last_release.released_atrequired | string (date-time) | |
card.slarequired | object | |
card.sla.first_response_minutesrequired | integer | |
card.sla.resolution_minutesrequired | integer | |
card.resale_pricerequired | number | |
card.white_label_missingrequired | array of enum | |
settingsrequired | object | |
settings.slarequired | object | |
settings.sla.first_response_minutesrequired | integer | |
settings.sla.resolution_minutesrequired | integer | |
settings.report_recipientsrequired | array of string (email) | |
settings.report_introrequired | string | |
settings.report_auto_sendrequired | boolean | |
settings.patterns_opt_inrequired | boolean | |
settings.organization_patterns_opt_inrequired | boolean | |
settings.localerequired | enum | Values en | it |
settings.brand_profile_idrequired | string | |
settings.resale_pricerequired | number | |
settings.collect_via_connectrequired | boolean | |
settings.managed_addonrequired | boolean | |
status_base_urlrequired | string (uri) | |
brand_namerequired | string |
GET/v1/agency/overview
One card per client: open tickets, approvals, escalations, medians, releases.
/v1/agency/overviewAuthentication: Dashboard session
Parameters
| Name | Type | Description |
|---|---|---|
periodquery | string |
Response 200
| Name | Type | Description |
|---|---|---|
periodrequired | string | |
clientsrequired | array of object | |
clients[].workspace_idrequired | string | |
clients[].workspace_namerequired | string | |
clients[].client_namerequired | string | |
clients[].slugrequired | string | |
clients[].open_ticketsrequired | integer | |
clients[].awaiting_approvalrequired | integer | |
clients[].escalationsrequired | integer | |
clients[].sla_breachedrequired | integer | |
clients[].tickets_receivedrequired | integer | |
clients[].tickets_resolvedrequired | integer | |
clients[].median_first_response_minutesrequired | number | |
clients[].median_release_minutesrequired | number | |
clients[].proactive_fixesrequired | integer | |
clients[].last_releaserequired | object | |
clients[].last_release.idrequired | string | |
clients[].last_release.versionrequired | string | |
clients[].last_release.tagrequired | string | |
clients[].last_release.released_atrequired | string (date-time) | |
clients[].slarequired | object | |
clients[].sla.first_response_minutesrequired | integer | |
clients[].sla.resolution_minutesrequired | integer | |
clients[].resale_pricerequired | number | |
clients[].white_label_missingrequired | array of enum | |
totalsrequired | object | |
totals.clientsrequired | integer | |
totals.open_ticketsrequired | integer | |
totals.awaiting_approvalrequired | integer | |
totals.escalationsrequired | integer | |
totals.sla_breachedrequired | integer | |
totals.tickets_receivedrequired | integer | |
totals.tickets_resolvedrequired | integer | |
totals.proactive_fixesrequired | integer | |
totals.median_first_response_minutesrequired | number | |
totals.median_release_minutesrequired | number |
GET/v1/agency/partner
The agency partner profile, certification and referred customers.
/v1/agency/partnerAuthentication: Dashboard session
Response 200
| Name | Type | Description |
|---|---|---|
statusrequired | enum | Values none | pending | certified |
profilerequired | object | |
profile.idrequired | string | |
profile.public_namerequired | string | |
profile.website_urlrequired | string (uri) | |
profile.descriptionrequired | string | |
profile.countryrequired | string | |
profile.logo_urlrequired | string (uri) | |
profile.certified_atrequired | string (date-time) | |
profile.listedrequired | boolean | |
profile.commission_raterequired | number | |
profile.review_requested_atrequired | string (date-time) | |
profile.created_atrequired | string (date-time) | |
referral_coderequired | string | |
referred_customersrequired | integer |
PUT/v1/agency/partner
Creates or changes the public partner profile; certification is decided by staff.
/v1/agency/partnerAuthentication: Dashboard session
Request body
| Name | Type | Description |
|---|---|---|
public_namerequired | string | |
website_urlrequired | string | |
descriptionrequired | string | |
countryrequired | string | |
logo_urlrequired | string |
Response 200
The same fields as GET /v1/agency/partner.
GET/v1/agency/queue
Approvals and escalations of every client in one queue, with the SLA timers.
/v1/agency/queueAuthentication: Dashboard session
Parameters
| Name | Type | Description |
|---|---|---|
cursorquery | string | |
limitquery | integer | |
clientquery | array of string | |
kindquery | array of enum | |
slaquery | array of enum | |
min_age_minutesquery | integer | |
max_age_minutesquery | integer | |
sortquery | enum | Values urgency | oldest | newest |
Response 200
| Name | Type | Description |
|---|---|---|
itemsrequired | array of object | |
items[].kindrequired | enum | Values draft | fix | escalation |
items[].ticketrequired | object | |
items[].ticket.idrequired | string | |
items[].ticket.org_idrequired | string | |
items[].ticket.workspace_idrequired | string | |
items[].ticket.workspace_namerequired | string | |
items[].ticket.client_namerequired | string | |
items[].ticket.channel_idrequired | string | |
items[].ticket.originrequired | enum | Values email | widget | github | proactive |
items[].ticket.external_idrequired | string | |
items[].ticket.customer_emailrequired | string | |
items[].ticket.customer_namerequired | string | |
items[].ticket.subjectrequired | string | |
items[].ticket.staterequired | enum | Values received | triage | needs_info | draft_ready | answered | fixing | awaiting_approval | releasing | customer_notified | closed | escalated |
items[].ticket.public_staterequired | enum | Values in_analysis | needs_reply | answered | fix_in_progress | releasing | resolved | team_review |
items[].ticket.categoryrequired | enum | Values usage | config | docs | bug | feature_request | unknown |
items[].ticket.priorityrequired | enum | Values low | normal | high | urgent |
items[].ticket.assignee_user_idrequired | string | |
items[].ticket.github_item_kindrequired | enum | Values issue | pull_request |
items[].ticket.github_numberrequired | integer | |
items[].ticket.labelsrequired | array of string | |
items[].ticket.languagerequired | string | |
items[].ticket.is_demorequired | boolean | |
items[].ticket.demorequired | boolean | |
items[].ticket.error_group_idrequired | string | |
items[].ticket.duplicate_of_ticket_idrequired | string | |
items[].ticket.resolved_versionrequired | string | |
items[].ticket.latest_confidencerequired | number | |
items[].ticket.needs_team_actionrequired | boolean | |
items[].ticket.message_countrequired | integer | |
items[].ticket.last_message_atrequired | string (date-time) | |
items[].ticket.first_response_atrequired | string (date-time) | |
items[].ticket.released_atrequired | string (date-time) | |
items[].ticket.closed_atrequired | string (date-time) | |
items[].ticket.last_customer_message_atrequired | string (date-time) | |
items[].ticket.sla_due_atrequired | string (date-time) | |
items[].ticket.reopened_countrequired | integer | |
items[].ticket.created_atrequired | string (date-time) | |
items[].ticket.updated_atrequired | string (date-time) | |
items[].waiting_sincerequired | string (date-time) | |
items[].waiting_minutesrequired | integer | |
items[].summaryrequired | string | |
items[].fixrequired | object | |
items[].fix.idrequired | string | |
items[].fix.attempt_numberrequired | integer | |
items[].fix.pr_numberrequired | integer | |
items[].fix.pr_urlrequired | string (uri) | |
items[].fix.head_sharequired | string | |
items[].fix.statusrequired | enum | Values prepared | proposed |
items[].fix.verified_byrequired | enum | Values harness | agent | server |
items[].fix.tests_passedrequired | boolean | |
items[].fix.diff_statsrequired | object | |
items[].fix.diff_stats.files_changedrequired | integer | |
items[].fix.diff_stats.additionsrequired | integer | |
items[].fix.diff_stats.deletionsrequired | integer | |
items[].slarequired | object | |
items[].sla.first_responserequired | object | |
items[].sla.first_response.due_atrequired | string (date-time) | |
items[].sla.first_response.statusrequired | enum | Values none | pending | breached | met | missed |
items[].sla.first_response.remaining_minutesrequired | integer | |
items[].sla.resolutionrequired | object | |
items[].sla.resolution.due_atrequired | string (date-time) | |
items[].sla.resolution.statusrequired | enum | Values none | pending | breached | met | missed |
items[].sla.resolution.remaining_minutesrequired | integer | |
items[].sla.breachedrequired | boolean | |
items[].sla.due_soonrequired | boolean | |
items[].sla.next_due_atrequired | string (date-time) | |
next_cursorrequired | string | |
releasesrequired | array of object | |
releases[].idrequired | string | |
releases[].org_idrequired | string | |
releases[].workspace_idrequired | string | |
releases[].repository_idrequired | string | |
releases[].tagrequired | string | |
releases[].versionrequired | string | |
releases[].sharequired | string | |
releases[].merged_sharequired | string | |
releases[].statusrequired | enum | Values proposed | approved | merging | tagged | ci_running | succeeded | failed |
releases[].ci_statusrequired | enum | Values pending | running | success | failure | none |
GET/v1/agency/reports
Monthly client reports, newest month first (clients see their own).
/v1/agency/reportsAuthentication: Dashboard session
Parameters
| Name | Type | Description |
|---|---|---|
cursorquery | string | |
limitquery | integer | |
workspace_idquery | string | |
periodquery | string |
Response 200
| Name | Type | Description |
|---|---|---|
itemsrequired | array of object | |
items[].idrequired | string | |
items[].workspace_idrequired | string | |
items[].workspace_namerequired | string | |
items[].client_namerequired | string | |
items[].periodrequired | string | |
items[].statusrequired | enum | Values draft | generated | sent | failed |
items[].metricsrequired | object | |
items[].metrics.tickets_receivedrequired | integer | |
items[].metrics.tickets_resolvedrequired | integer | |
items[].metrics.median_first_response_minutesrequired | number | |
items[].metrics.median_release_minutesrequired | number | |
items[].metrics.releasesrequired | integer | |
items[].metrics.proactive_fixesrequired | integer | |
items[].metrics.top_modulesrequired | array of object | |
items[].metrics.top_modules[].modulerequired | string | |
items[].metrics.top_modules[].ticketsrequired | integer | |
items[].metrics.by_categoryrequired | object | |
items[].intro_mdrequired | string | |
items[].sent_torequired | array of string (email) | |
items[].sent_atrequired | string (date-time) | |
items[].generated_atrequired | string (date-time) | |
items[].created_atrequired | string (date-time) | |
items[].pdf_pathrequired | string | |
next_cursorrequired | string | |
latest_periodrequired | string |
POST/v1/agency/reports
Generates the report of a client for a month (idempotent per month).
/v1/agency/reportsAuthentication: Dashboard session
Request body
| Name | Type | Description |
|---|---|---|
workspace_idrequired | string | |
periodrequired | string | |
regenerate | boolean |
Response 201
| Name | Type | Description |
|---|---|---|
idrequired | string | |
workspace_idrequired | string | |
workspace_namerequired | string | |
client_namerequired | string | |
periodrequired | string | |
statusrequired | enum | Values draft | generated | sent | failed |
metricsrequired | object | |
metrics.tickets_receivedrequired | integer | |
metrics.tickets_resolvedrequired | integer | |
metrics.median_first_response_minutesrequired | number | |
metrics.median_release_minutesrequired | number | |
metrics.releasesrequired | integer | |
metrics.proactive_fixesrequired | integer | |
metrics.top_modulesrequired | array of object | |
metrics.top_modules[].modulerequired | string | |
metrics.top_modules[].ticketsrequired | integer | |
metrics.by_categoryrequired | object | |
intro_mdrequired | string | |
sent_torequired | array of string (email) | |
sent_atrequired | string (date-time) | |
generated_atrequired | string (date-time) | |
created_atrequired | string (date-time) | |
pdf_pathrequired | string |
GET/v1/agency/reports/{id}
One monthly client report.
/v1/agency/reports/{id}Authentication: Dashboard session
Parameters
| Name | Type | Description |
|---|---|---|
idpathrequired | string |
Response 200
The same fields as POST /v1/agency/reports.
POST/v1/agency/reports/{id}/send
Emails the report with the agency brand to its recipients.
/v1/agency/reports/{id}/sendAuthentication: Dashboard session
Parameters
| Name | Type | Description |
|---|---|---|
idpathrequired | string |
Request body
| Name | Type | Description |
|---|---|---|
recipients | array of string |
Response 200
The same fields as POST /v1/agency/reports.
GET/v1/agency/resale
Resale prices, workspace costs and margins of every client.
/v1/agency/resaleAuthentication: Dashboard session
Response 200
| Name | Type | Description |
|---|---|---|
planrequired | enum | Values none | open_source | indie | startup | growth | managed | agency | enterprise |
currencyrequired | "USD" | |
clientsrequired | array of object | |
clients[].workspace_idrequired | string | |
clients[].workspace_namerequired | string | |
clients[].client_namerequired | string | |
clients[].resale_pricerequired | number | |
clients[].unit_cost_usdrequired | number | |
clients[].margin_usdrequired | number | |
clients[].collect_via_connectrequired | boolean | |
clients[].managed_addonrequired | boolean | |
clients[].collectionrequired | object | |
clients[].collection.statusrequired | enum | Values pending | active | past_due | canceled |
clients[].collection.client_emailrequired | string (email) | |
clients[].collection.hosted_invoice_urlrequired | string | |
clients[].collection.last_checkrequired | enum | Values verified | mismatch |
totalsrequired | object | |
totals.revenue_usdrequired | number | |
totals.cost_usdrequired | number | |
totals.margin_usdrequired | number | |
totals.priced_clientsrequired | integer | |
totals.collected_margin_this_month_usdrequired | number | |
connectrequired | object | |
connect.statusrequired | enum | Values not_started | pending | active | restricted |
connect.account_linkedrequired | boolean | |
connect.charges_enabledrequired | boolean | |
connect.payouts_enabledrequired | boolean | |
connect.collecting_clientsrequired | integer |
GET/v1/agency/white-label
White-label readiness of every client: brand, sender, domains.
/v1/agency/white-labelAuthentication: Dashboard session
Response 200
| Name | Type | Description |
|---|---|---|
default_profilerequired | object | |
default_profile.idrequired | string | |
default_profile.namerequired | string | |
default_profile.logorequired | boolean | |
default_profile.primary_colorrequired | string | |
profilesrequired | array of object | |
profiles[].idrequired | string | |
profiles[].namerequired | string | |
profiles[].is_defaultrequired | boolean | |
clientsrequired | array of object | |
clients[].workspace_idrequired | string | |
clients[].workspace_namerequired | string | |
clients[].client_namerequired | string | |
clients[].brand_profile_idrequired | string | |
clients[].effective_profile_idrequired | string | |
clients[].brand_namerequired | string | |
clients[].readyrequired | boolean | |
clients[].missingrequired | array of enum | |
clients[].senderrequired | string | |
clients[].sending_domainrequired | object | |
clients[].sending_domain.domainrequired | string | |
clients[].sending_domain.verifiedrequired | boolean | |
clients[].inbound_domainrequired | object | |
clients[].inbound_domain.domainrequired | string | |
clients[].inbound_domain.verifiedrequired | boolean | |
clients[].status_domainrequired | object | |
clients[].status_domain.domainrequired | string | |
clients[].status_domain.verifiedrequired | boolean | |
clients[].status_base_urlrequired | string (uri) | |
clients[].drafts_waitingrequired | integer | |
readyrequired | integer | |
totalrequired | integer |