bugsnag Organizations API
Access and manage organizations. An organization is the top-level entity in Bugsnag that contains projects and collaborators.
Operations 41
Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay
Ask an LLM
“Which BugSnag organizations do I belong to?”
“Can I page through the organizations my account is a member of?”
Tell an agent
List the organizations I belong to.
Show my organizations, {per_page} per page.
GET
/organizations/{organization_id}
Get an organization's billing email and slug · Get an organization
#
Ask an LLM
“What billing email and slug are set on my organization?”
“When was my organization created?”
Tell an agent
Get the name, slug and billing email of organization {organization_id}.
Show when organization {organization_id} was created.
Ask an LLM
“How do I start a brand-new BugSnag organization?”
“Does creating an organization make me its admin?”
Tell an agent
Create an organization named {name}.
Set up a new organization called {name} with me as admin.
Ask an LLM
“How do I pull up an organization's complete record by its ID?”
“Can I check an organization's auto-upgrade and invoice settings?”
Tell an agent
View the organization record {id}.
Show invoice and auto-upgrade settings for organization {id}.
Ask an LLM
“How do I change my organization's billing emails or invoice address?”
“Can I turn automatic plan upgrades off for my organization?”
Tell an agent
Rename organization {id} to {name} with auto-upgrade {auto_upgrade}.
Set billing emails for organization {id} to {billing_emails}, keeping name {name} and auto-upgrade {auto_upgrade}.
Ask an LLM
“Can I shut down and delete an entire BugSnag organization?”
“How do I remove an organization I no longer use?”
Tell an agent destructive · confirm first
Delete organization {id}.
Permanently close organization {id}.
DELETE
/organizations/{id}/api_key
Regenerate an organization's API key · Regenerate an Organization's API key
#
Ask an LLM
“How do I rotate my organization's API key if it leaked?”
“Does regenerating the organization API key invalidate the old one?”
Tell an agent destructive · confirm first
Regenerate the API key for organization {id}.
Rotate organization {id}'s API key.
DELETE
/organizations/{id}/auth_token
Regenerate the deprecated organization auth token · Regenerate an Organization's auth token
#
Ask an LLM
“Can I still regenerate the old organization-level data access auth token?”
“Is the organization auth token deprecated in favor of user tokens?”
Tell an agent destructive · confirm first
Regenerate the organization auth token for {id}.
Issue a new data access auth token for organization {id}.
GET
/organizations/{organization_id}/collaborators/{id}
Show an organization collaborator · Show a Collaborator on an Organization
#
Ask an LLM
“What does a collaborator's organization membership record contain?”
“How do I look up one member of my organization?”
Tell an agent
Show collaborator {id} on organization {organization_id}.
Look up member {id} in organization {organization_id}.
PATCH
/organizations/{organization_id}/collaborators/{id}
Change a member's project roles or admin rights · Update a Collaborator's permissions
#
Ask an LLM
“Can I set per-project roles for an existing member?”
“How do I grant or revoke admin rights for a member?”
Tell an agent
Set member {id} in organization {organization_id} to project roles {project_roles}.
Set admin to {admin} for member {id} of organization {organization_id}.
DELETE
/organizations/{organization_id}/collaborators/{id}
Remove a member from an organization · Delete a Collaborator
#
Ask an LLM
“How do I take someone out of my organization?”
“Can I delete a collaborator who has left the company?”
Tell an agent destructive · confirm first
Delete collaborator {id} from organization {organization_id}.
Remove member {id} from organization {organization_id}.
POST
/organizations/{organization_id}/collaborators/bulk_invite
Invite several people at once · Bulk invite collaborators to your organization
#
Ask an LLM
“Can I invite a whole list of email addresses to my organization in one request?”
“How do I bulk invite teammates with the same project roles?”
Tell an agent
Invite {emails} to organization {organization_id}.
Bulk invite {emails} to organization {organization_id} with access to projects {project_ids}.
GET
/projects/{project_id}/collaborators
List who can access a project · List Collaborators on a Project
#
Ask an LLM
“Who has access to a particular project?”
“Can I list the collaborators on one project rather than the whole organization?”
Tell an agent
List collaborators on project {project_id}.
Show everyone with access to project {project_id}.
GET
/projects/{project_id}/collaborators/{id}
Show a collaborator within a project · Show a collaborator in a project
#
Ask an LLM
“What does one collaborator's record look like inside a specific project?”
“Do I need access to a project to view its collaborators?”
Tell an agent
Show collaborator {id} in project {project_id}.
Get project {project_id}'s record for collaborator {id}.
GET
/organizations/{organization_id}/collaborators/project_access_counts
Count projects each collaborator can access · View the project count of a collaborator
#
Ask an LLM
“How many projects does each of these collaborators have access to?”
“Can I get project access counts for several collaborators at once?”
Tell an agent
Count project access for collaborators {collaborator_ids} in organization {organization_id}.
Show how many projects collaborators {collaborator_ids} can reach in organization {organization_id}.
GET
/organizations/{organization_id}/collaborators/{collaborator_id}/projects
View projects a collaborator can access · View Projects a Collaborator has access to
#
Ask an LLM
“Which projects can a given collaborator open?”
“Can I search a collaborator's accessible projects by name?”
Tell an agent
List the projects collaborator {collaborator_id} can access in organization {organization_id}.
Search collaborator {collaborator_id}'s projects in organization {organization_id} for {q}.
GET
/organizations/{organization_id}/collaborators/{collaborator_id}/project_accesses
List a collaborator's project access records · List project accesses for a collaborator
#
Ask an LLM
“What project access grants does a collaborator hold in the organization?”
“Can I page through a collaborator's project access entries?”
Tell an agent
List project access records for collaborator {collaborator_id} in organization {organization_id}.
Show {per_page} project access grants per page for collaborator {collaborator_id} in organization {organization_id}.
GET
/organizations/{organization_id}/collaborators/{collaborator_id}/project_accesses/{project_id}
Get a collaborator's access to one project · Show a Collaborator's Access Details for a Project
#
Ask an LLM
“What role does a collaborator have on one specific project?”
“How was a collaborator given access to a particular project?”
Tell an agent
Show collaborator {collaborator_id}'s access to project {project_id} in organization {organization_id}.
Get the access details for {collaborator_id} on project {project_id} in organization {organization_id}.
POST
/organizations/{organization_id}/collaborators/{id}/team_memberships
Add a collaborator to teams · Add a collaborator to a group of Teams
#
Ask an LLM
“How do I put one collaborator on several teams at once?”
“Can I add a collaborator to every team in the organization?”
Tell an agent
Add collaborator {id} to teams {team_ids} in organization {organization_id}.
Put collaborator {id} on every team in organization {organization_id} (add_all_teams {add_all_teams}).
DELETE
/organizations/{organization_id}/collaborators/{id}/team_memberships
Remove a collaborator from teams · Remove a Collaborator from a group of Teams
#
Ask an LLM
“How do I take one collaborator off a group of teams?”
“Can I remove a person from teams without removing them from the organization?”
Tell an agent destructive · confirm first
Remove collaborator {id} from teams in organization {organization_id}.
Take collaborator {id} off their teams in organization {organization_id}.
GET
/organizations/{organization_id}/teams
List or search an organization's teams · List Teams from a query
#
Ask an LLM
“What teams exist in my organization?”
“Can I search my organization's teams by name?”
Tell an agent
List teams in organization {organization_id}.
Find teams in organization {organization_id} matching {q}.
Ask an LLM
“How do I create a new team in my organization?”
“Can I group collaborators into a named team?”
Tell an agent
Create a team called {name} in organization {organization_id}.
Add a new team {name} to organization {organization_id}.
GET
/organizations/{organization_id}/teams/{id}
Show a team's details · Show the details of a team
#
Ask an LLM
“What are the details of a particular team?”
“How do I look up one team by its ID?”
Tell an agent
Show team {id} in organization {organization_id}.
Get details of team {id} from organization {organization_id}.
Ask an LLM
“How do I rename an existing team?”
“Can I change a team's name after creating it?”
Tell an agent
Rename team {id} in organization {organization_id} to {name}.
Change the name of team {id} in organization {organization_id} to {name}.
Ask an LLM
“Can I delete a team we no longer need?”
“How do I get rid of a team in my organization?”
Tell an agent destructive · confirm first
Delete team {id} from organization {organization_id}.
Remove the team {id} in organization {organization_id}.
GET
/organizations/{organization_id}/teams/{id}/suggested_collaborators
Suggest collaborators to add to a team · List Suggested Collaborators to Add to a Team
#
Ask an LLM
“Which collaborators could I add to this team?”
“Can team member suggestions include people who already have access?”
Tell an agent
Suggest collaborators to add to team {id} in organization {organization_id}.
Find suggested collaborators for team {id} in organization {organization_id} matching {q}.
GET
/organizations/{organization_id}/collaborators/{id}/teams
List the teams a collaborator is on · List Teams for a Collaborator
#
Ask an LLM
“Which teams is a given collaborator a member of?”
“Can I search a collaborator's teams by name?”
Tell an agent
List teams for collaborator {id} in organization {organization_id}.
Search collaborator {id}'s teams in organization {organization_id} for {q}.
GET
/organizations/{organization_id}/collaborators/{id}/suggested_teams
Suggest teams for a collaborator to join · List Suggested Teams for a Collaborator
#
Ask an LLM
“Which teams could a collaborator be added to?”
“Can team suggestions for a person also flag teams they are already in?”
Tell an agent
Suggest teams for collaborator {id} in organization {organization_id}.
List suggested teams for collaborator {id} in organization {organization_id}, including membership {include_is_member}.
GET
/organizations/{organization_id}/teams/{id}/collaborators
List members of a team · List the Collaborators in a Team
#
Ask an LLM
“Who is on a particular team?”
“Can I search a team's members by name?”
Tell an agent
List members of team {id} in organization {organization_id}.
Search team {id}'s members in organization {organization_id} for {q}.
POST
/organizations/{organization_id}/teams/{id}/team_memberships
Add collaborators to a team · Add Collaborators to a Team
#
Ask an LLM
“How do I add several people to a team at once?”
“Can I add every collaborator in the organization to one team?”
Tell an agent
Put users {collaborator_ids} onto team {id} in organization {organization_id}.
Fill team {id} in organization {organization_id} with everyone in the organization (add_all_collaborators {add_all_collaborators}).
DELETE
/organizations/{organization_id}/teams/{id}/team_memberships
Remove collaborators from a team · Remove Collaborators from a Team
#
Ask an LLM
“How do I remove several people from a team?”
“Can I take members off a team without deleting the team?”
Tell an agent destructive · confirm first
Remove members from team {id} in organization {organization_id}.
Take the listed users off team {id} in organization {organization_id}.
GET
/organizations/{organization_id}/teams/{id}/project_accesses
List projects a team can access · List Project Access for a Team
#
Ask an LLM
“Which projects does a team have access to?”
“Can I search a team's project access by project name?”
Tell an agent
List project access for team {id} in organization {organization_id}.
Search team {id}'s accessible projects in organization {organization_id} for {q}.
PATCH
/organizations/{organization_id}/teams/{id}/project_accesses
Grant a team access to projects · Add Project Access to a Team
#
Ask an LLM
“How do I give a team access to every project?”
“Can I set the role a team gets on the projects it can access?”
Tell an agent
Give team {id} in organization {organization_id} access to all projects: {add_all_projects}.
Grant team {id} in organization {organization_id} project roles {project_roles}.
DELETE
/organizations/{organization_id}/teams/{id}/project_accesses
Remove a team's access to projects · Remove Project Access from a Team
#
Ask an LLM
“How do I revoke a team's access to certain projects?”
“Can I take projects away from a team without deleting it?”
Tell an agent destructive · confirm first
Remove project access from team {id} in organization {organization_id}.
Revoke team {id}'s access to the given projects in organization {organization_id}.
GET
/organizations/{organization_id}/teams/{id}/suggested_projects
Suggest projects to give a team · Suggest Projects to Add to a Team
#
Ask an LLM
“Which projects could I give this team access to?”
“Can project suggestions for a team exclude ones it already has?”
Tell an agent
Suggest projects for team {id} in organization {organization_id}.
List suggested projects for team {id} in organization {organization_id} matching {q}.
POST
/organizations/{organization_id}/event_data_requests
Request an organization-wide event export · Create an event data request
#
Ask an LLM
“How do I export all event data across my organization?”
“Can I request an organization data export for a GDPR subject access request?”
Tell an agent
Start an event data export for organization {organization_id} with filters {filters}.
Request a {report_type} event export for organization {organization_id} filtered by {filters}.
GET
/organizations/{organization_id}/event_data_requests/{id}
Check an organization export's status · Check the status of an event data request
#
Ask an LLM
“Is my organization-wide event data export ready to download?”
“How do I check progress on an organization data request?”
Tell an agent
Check the status of event data request {id} for organization {organization_id}.
Get the download status of organization {organization_id} export {id}.
POST
/organizations/{organization_id}/event_data_deletions
Request an organization-wide event deletion · Create an event deletion request
#
Ask an LLM
“How do I delete a user's events across every project in my organization?”
“Do email filters in an organization deletion request match substrings?”
Tell an agent destructive · confirm first
Request deletion of events matching {filters} across organization {organization_id}.
Delete organization {organization_id} events matching {filters} with skip confirmation {skip_confirmation}.
POST
/organizations/{organization_id}/event_data_deletions/{id}/confirm
Confirm an organization event deletion · Confirm an event deletion request
#
Ask an LLM
“How do I confirm a pending organization-wide event deletion?”
“Does an organization deletion request wait for confirmation before running?”
Tell an agent destructive · confirm first
Confirm event deletion request {id} for organization {organization_id}.
Go ahead with organization {organization_id} deletion {id}.
GET
/organizations/{organization_id}/event_data_deletions/{id}
Check an organization deletion's status · Check the status of an event deletion request
#
Ask an LLM
“Has my organization-wide event deletion finished?”
“How do I track an organization deletion request?”
Tell an agent
Check the status of deletion request {id} in organization {organization_id}.
Show progress of organization {organization_id} event deletion {id}.
GET
/organizations/{organization_id}/traces/{trace_id}/spans
List an organization-level trace's spans · List Spans for a Trace
#
Ask an LLM
“How do I see all spans in a distributed trace across my organization?”
“What permission do I need to view organization-level trace spans?”
Tell an agent
List spans for trace {trace_id} in organization {organization_id} from {from} to {to}.
Show organization {organization_id} trace {trace_id} around span {target_span_id} between {from} and {to}.