Companies
Update a company
Changes the given fields of one company in the authenticated team's Data Library and returns the updated company. A name, UEI, CAGE code or DUNS number another company on the team already uses answers conflict without changing anything. Companies on other teams or sub-teams, or above the token's classification ceiling, are reported as not found.
patchhttps://api.govdash.us/v1/companies/{id}
Authorization
Your API key as a bearer token, for example Bearer gd_live_....
See Authentication for how to create a key.
Path parameters
Company identifier.
Headers
The dated API version this request is written against. Responses keep that version's shape after newer versions ship.
One of:
Body
application/jsonFields to change. Send at least one; omitted fields keep their values.
Show child attributesHide child attributes
First line of the street address.
Second line of the street address.
City.
State or region name.
State or region code, such as VA.
Postal or ZIP code.
Country name.
Country code, such as US.
Legal name, unique within the team. At most 250 characters and not only whitespace.
How the company relates to the team.
One of:
Doing-business-as or trade name. null clears it.
Website URL. null clears it.
Free-text notes on the relationship with the team. null clears them.
12-character SAM Unique Entity Identifier, unique within the team.
5-character CAGE code, unique within the team.
DUNS number. null clears it.
Response
200 · application/jsonA company in the team's Data Library.
Company identifier.
Object type, always company.
Data classification of the company.
One of:
Legal name, unique within the team.
Doing-business-as or trade name.
How the company relates to the team.
One of:
Free-text notes on the relationship with the team.
Website URL.
SAM Unique Entity Identifier.
CAGE code.
DUNS number.
When the company was last updated.
Primary address. null when none is recorded.
Show child attributesHide child attributes
First line of the street address.
Second line of the street address.
City.
State or region name.
State or region code, such as VA.
Postal or ZIP code.
Country name.
Country code, such as US.
Errors
Every error returns a stable error.code to branch on and an error.message that says what went wrong, like the examples below. See Errors for how to handle each one.
The body is empty, has a field this endpoint doesn't accept, or a field has the wrong type. The message names the field.
Invalid request body: Expected a value with at least 1 entry
The key's service account doesn't have the permission this needs, or your team's access has ended.
You do not have permission to perform this action.
The record doesn't exist, belongs to another team, or is above the key's classification.
The requested resource was not found.
A record like this already exists. Use it instead of creating another.
The request conflicts with an existing resource.
The request is well formed, but GovDash won't make this change. The message says why, when it can.
The request failed validation.
You sent too many requests. Wait the seconds in the retry-after header, then retry.
This access token exceeded its write rate limit.
Something went wrong on GovDash's side, usually a bug. Retry with backoff, and check before retrying a create.
An unexpected error occurred.
GovDash is briefly unavailable and didn't run the request. Retry after retry-after.
The service is temporarily unavailable. Try again later.