Skip to content

All integrations

Connect OpenAI to ShipVitals

API costs and token usage by project

AvailableKey, not read-only · about 2 minutes

Connect OpenAI

What it reads

Admin key
The only key that reads organisation costs and usage.

Not read-only at OpenAI. ShipVitals calls only the organisation costs, usage and projects endpoints. An Admin key could also manage members, projects and keys.

What ShipVitals keeps: The Admin key, encrypted.

Every connector's scopes, on one page

How to connect

  1. Open Settings → Organization → Admin keys in OpenAI.
  2. Choose Create new admin key, and name it ShipVitals.
  3. Copy the key. It starts with sk-admin-, and OpenAI shows it once.

About 2 minutes.

Open OpenAI

How to revoke

Revoke it at OpenAI

Removing the connection in ShipVitals deletes the stored key at once.

What it powers

Dashboard tabs: Costs.

Figures it fills

  • ai.tokens.input
  • ai.tokens.cached
  • ai.tokens.output
  • ai.requests

Sync

  • Free: Daily
  • Indie: Hourly
  • Studio: Every 15 minutes
  • Agency: Every 15 minutes

Troubleshooting

Each error a connection can hit, and its fix. The connection's health page names the one it hit.

Access refused
OpenAI no longer accepts what ShipVitals signs in with. Create a new key, or connect again, and replace it in the connection.
A permission is missing
What ShipVitals has can't read everything it needs. Add the permissions under What it reads, or create a new key with them, and test again.
Access removed
ShipVitals' access was removed in OpenAI. Connect it again; the history it brought in is kept.
Rate-limited
OpenAI asked ShipVitals to slow down. Nothing to do: the sync carries on by itself and catches up.
Quota reached
The account used up a OpenAI quota. The sync resumes when the quota resets.
Not found
Something the connection reads is gone from OpenAI: renamed, moved or removed. Review the connection's resources, or connect again.
OpenAI is unavailable
OpenAI is having trouble on its side. Check its status page; ShipVitals retries by itself.
Couldn't reach OpenAI
The request didn't get through. ShipVitals retries by itself; if it keeps failing, check that OpenAI is reachable.
An answer ShipVitals didn't expect
OpenAI answered in a shape ShipVitals didn't expect, usually after a change on its side. We're told, and the data you have is kept.
A setting doesn't work
A field in the connection doesn't work with OpenAI. Check it against How to connect, and test again.

Docs