GovDash
Menu

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

Authorizationstringheaderrequired

Your API key as a bearer token, for example Bearer gd_live_....

See Authentication for how to create a key.

Path parameters

idstringpathrequired

Company identifier.

Headers

govdash-versionenumheaderrequired

The dated API version this request is written against. Responses keep that version's shape after newer versions ship.

One of:2026-11-17

Body

application/json

Fields to change. Send at least one; omitted fields keep their values.

locationobject | null
Show child attributes
address_line_1string | nullrequired

First line of the street address.

address_line_2string | nullrequired

Second line of the street address.

citystring | nullrequired

City.

statestring | nullrequired

State or region name.

state_codestring | nullrequired

State or region code, such as VA.

postal_codestring | nullrequired

Postal or ZIP code.

countrystring | nullrequired

Country name.

country_codestring | nullrequired

Country code, such as US.

namestring

Legal name, unique within the team. At most 250 characters and not only whitespace.

relationship_typeenum

How the company relates to the team.

One of:JOINT_VENTURE_MEMBERSUBSIDIARYPARENT_COMPANYVENDORCUSTOMERUNKNOWN

dba_namestring | null

Doing-business-as or trade name. null clears it.

website_urlstring | null

Website URL. null clears it.

relationship_notesstring | null

Free-text notes on the relationship with the team. null clears them.

ueistring | null

12-character SAM Unique Entity Identifier, unique within the team.

cage_codestring | null

5-character CAGE code, unique within the team.

duns_numberstring | null

DUNS number. null clears it.

Response

200 · application/json

A company in the team's Data Library.

idstring

Company identifier.

objectstring

Object type, always company.

classificationenum

Data classification of the company.

One of:UNCLASSIFIEDCUI

namestring

Legal name, unique within the team.

dba_namestring | null

Doing-business-as or trade name.

relationship_typeenum

How the company relates to the team.

One of:PRIME_CONTRACTORSUB_CONTRACTORTEAM_ARRANGEMENT_MEMBERJOINT_VENTURE_MEMBERSUBSIDIARYPARENT_COMPANYUNKNOWNSUPPLIERCUSTOMERCOMPETITORVENDORINCUMBENTOUR_TEAM

relationship_notesstring | null

Free-text notes on the relationship with the team.

website_urlstring | null

Website URL.

ueistring | null

SAM Unique Entity Identifier.

cage_codestring | null

CAGE code.

duns_numberstring | null

DUNS number.

updated_atstring (date-time)

When the company was last updated.

locationobject | null

Primary address. null when none is recorded.

Show child attributes
address_line_1string | null

First line of the street address.

address_line_2string | null

Second line of the street address.

citystring | null

City.

statestring | null

State or region name.

state_codestring | null

State or region code, such as VA.

postal_codestring | null

Postal or ZIP code.

countrystring | null

Country name.

country_codestring | null

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.

400bad_request

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

401unauthorized

The API key is missing, mistyped, revoked, or expired.

The bearer token is missing or invalid.

403forbiddenclassification_out_of_scope

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.

404not_found

The record doesn't exist, belongs to another team, or is above the key's classification.

The requested resource was not found.

409conflict

A record like this already exists. Use it instead of creating another.

The request conflicts with an existing resource.

413payload_too_large

The request body is over 1 MB.

The request body must not exceed 1 MB.

422validation_failed

The request is well formed, but GovDash won't make this change. The message says why, when it can.

The request failed validation.

429rate_limited

You sent too many requests. Wait the seconds in the retry-after header, then retry.

This access token exceeded its write rate limit.

500internal_error

Something went wrong on GovDash's side, usually a bug. Retry with backoff, and check before retrying a create.

An unexpected error occurred.

503service_unavailable

GovDash is briefly unavailable and didn't run the request. Retry after retry-after.

The service is temporarily unavailable. Try again later.

patch/v1/companies/{id}

Update a company

Sends a real PATCH request that changes your team's data.

Path parameters
string, required

Company identifier.

Body

Starts with the required fields. The Body section of this page lists every field.

Bearer

Kept in this tab only. Use a key you can revoke.

Request
Response
Send the request to see the response.