Capacity Planner API

REST API for the Speed Team Capacity Management tool. Authenticate with a session cookie (browser) or a Bearer API key (programmatic access).

Authentication

Bearer API key — create a key at /settings, then pass it as:

Authorization: Bearer cap_...

Session cookie — sign in at /login (NVIDIA SSO). Browsers use this automatically.

Method	Path	Summary
get	/api/resources	List resources
post	/api/resources	Create resource
get	/api/resources/{id}	Get resource
put	/api/resources/{id}	Update resource
delete	/api/resources/{id}	Delete resource
post	/api/allocation-lines	Create allocation line
patch	/api/allocation-lines/{id}	Update allocation line (category, project, notes)
delete	/api/allocation-lines/{id}	Delete allocation line and its monthly values
post	/api/allocations	Bulk upsert monthly allocations
get	/api/availability	List availability overrides
post	/api/availability	Upsert availability
get	/api/capacity	List capacity rows
post	/api/capacity	Upsert capacity row
get	/api/projects	Search projects
get	/api/portfolios	List portfolios
post	/api/portfolios	Create portfolio
delete	/api/portfolios/{id}	Delete portfolio
get	/api/managers	List managers
post	/api/managers	Create manager
delete	/api/managers/{id}	Delete manager
get	/api/regions	List regions
post	/api/regions	Create region
delete	/api/regions/{id}	Delete region
get	/api/config	Get app config
post	/api/config	Update app config
get	/api/export	Export allocation data as CSV
get	/api/api-keys	List active API keys (metadata only — no raw keys)
post	/api/api-keys	Create API key (raw key returned once — store it)
delete	/api/api-keys/{id}	Revoke API key (soft-delete)

get/api/resources

List resources

Returns all resources. Supports filtering by managerId, portfolioId, and status.

Parameters

Name	In	Type	Required
managerId	query	string	no
portfolioId	query	string	no
status	query	string (Active\|NotActive)	no

Responses

200Array of resources with manager, portfolio, region

post/api/resources

Create resource

Responses

201Created resource

get/api/resources/{id}

Get resource

Parameters

Name	In	Type	Required
id	path	string	yes

Responses

200Resource with allocation lines

put/api/resources/{id}

Update resource

Parameters

Name	In	Type	Required
id	path	string	yes

Responses

200Updated resource

delete/api/resources/{id}

Delete resource

Parameters

Name	In	Type	Required
id	path	string	yes

Responses

204Deleted

post/api/allocation-lines

Create allocation line

Responses

201Created allocation line

patch/api/allocation-lines/{id}

Update allocation line (category, project, notes)

Parameters

Name	In	Type	Required
id	path	string	yes

Responses

200Updated

delete/api/allocation-lines/{id}

Delete allocation line and its monthly values

Parameters

Name	In	Type	Required
id	path	string	yes

Responses

204Deleted

post/api/allocations

Bulk upsert monthly allocations

Responses

200Upserted count

get/api/availability

List availability overrides

Parameters

Name	In	Type	Required
resourceId	query	string	no
from	query	string	no
to	query	string	no

Responses

200Array of availability rows

post/api/availability

Upsert availability

Responses

200Upserted

get/api/capacity

List capacity rows

Responses

200Array of capacity rows

post/api/capacity

Upsert capacity row

Responses

200Upserted

get/api/projects

Search projects

Parameters

Name	In	Type	Required
q	query	string	no
limit	query	integer	no

Responses

200Array of projects

get/api/portfolios

List portfolios

Responses

200Array of portfolios

post/api/portfolios

Create portfolio

Responses

201Created

delete/api/portfolios/{id}

Delete portfolio

Parameters

Name	In	Type	Required
id	path	string	yes

Responses

204Deleted

get/api/managers

List managers

Responses

200Array of managers

post/api/managers

Create manager

Responses

201Created

delete/api/managers/{id}

Delete manager

Parameters

Name	In	Type	Required
id	path	string	yes

Responses

204Deleted

get/api/regions

List regions

Responses

200Array of regions

post/api/regions

Create region

Responses

201Created

delete/api/regions/{id}

Delete region

Parameters

Name	In	Type	Required
id	path	string	yes

Responses

204Deleted

get/api/config

Get app config

Responses

200AppConfig singleton

post/api/config

Update app config

Responses

200Updated config

get/api/export

Export allocation data as CSV

Responses

200CSV file

get/api/api-keys

List active API keys (metadata only — no raw keys)

Responses

200Array of API key metadata

post/api/api-keys

Create API key (raw key returned once — store it)

Responses

201Created key with one-time raw value

delete/api/api-keys/{id}

Revoke API key (soft-delete)

Parameters

Name	In	Type	Required
id	path	string	yes

Responses

204Revoked

404Not found