projects

POST /v1/projects/{projectsId}/locations/{locationsId}/curations

Changed on Nov 8, 2026

Create a curation resource in the API hub. Once a curation resource is created, plugin instances can start using it.

Request

Base URL
https://apihub.googleapis.com
Auth
- OAuth 2 and OAuth 2
  Implicithttps://accounts.google.com/o/oauth2/auth
  Scopeshttps://www.googleapis.com/auth/apihub.readwrite
  Authorization codehttps://accounts.google.com/o/oauth2/auth
  Token URLhttps://accounts.google.com/o/oauth2/token
  Scopeshttps://www.googleapis.com/auth/apihub.readwrite
- or OAuth 2 and OAuth 2
  Implicithttps://accounts.google.com/o/oauth2/auth
  Scopeshttps://www.googleapis.com/auth/cloud-platform
  Authorization codehttps://accounts.google.com/o/oauth2/auth
  Token URLhttps://accounts.google.com/o/oauth2/token
  Scopeshttps://www.googleapis.com/auth/cloud-platform
TypeScript
https://skmtc.dev/google/apis/apihub/docs/v1/projects/:projectsId/locations/:locationsId/curations/post.ts
A function with typed inputs. Its response is checked against the schema.

Path parameters

projectsIdstring required

locationsIdstring required

Query parameters

curationIdstring

Optional. The ID to use for the curation resource, which will become the final component of the curations's resource name. This field is optional. * If provided, the same will be used. The service will throw an error if the specified ID is already used by another curation resource in the API hub. * If not provided, a system generated ID will be used. This value should be 4-500 characters, and valid characters are /a-z[0-9]-_/.

Request body

createTimestring google-datetime

Output only. The time at which the curation was created.

descriptionstring

Optional. The description of the curation.

displayNamestring

Required. The display name of the curation.

lastExecutionErrorCode'ERROR_CODE_UNSPECIFIED' | 'INTERNAL_ERROR' | 'UNAUTHORIZED'

Output only. The error code of the last execution of the curation. The error code is populated only when the last execution state is failed.

lastExecutionErrorMessagestring

Output only. Error message describing the failure, if any, during the last execution of the curation.

lastExecutionState'LAST_EXECUTION_STATE_UNSPECIFIED' | 'SUCCEEDED' | 'FAILED'

Output only. The last execution state of the curation.

namestring

Identifier. The name of the curation. Format: projects/{project}/locations/{location}/curations/{curation}

updateTimestring google-datetime

Output only. The time at which the curation was last updated.

Response

Successful response