- List assets in the specified space's master environment. Companion to the
`ContentManagement.Asset.publish`, `ContentManagement.Asset.save`, and
`ContentManagement.Asset.create` webhooks.
- Retrieve a single asset by its ID from the specified space's master environment.
Use this to fetch the current `sys.version` before any update/delete/publish/unpublish/process
call.
- Create a new asset in the specified space's master environment. Fires the
`ContentManagement.Asset.create` webhook. Server generates the asset ID; response
`sys.version` is 1. Asset is NOT yet processed or published — call `process_asset`
then `publish_asset` to complete the workflow.
- Update an existing asset by ID. Fires the `ContentManagement.Asset.save` webhook.
Requires X-Contentful-Version optimistic-lock header — Contentful returns 409 on
version mismatch.
- Permanently delete an asset by ID. Fires the `ContentManagement.Asset.delete` webhook.
Asset MUST be unpublished first — Contentful rejects deletion of a currently-published
asset with a 400.
- Publish an asset so it becomes available on the Content Delivery API. Fires the
`ContentManagement.Asset.publish` webhook. Asset MUST have been processed (via
`process_asset`) for every locale that has file data — otherwise Contentful returns
422 ValidationFailed.
- Unpublish an asset — its draft is retained but the published version is removed from
the Content Delivery API. Fires the `ContentManagement.Asset.unpublish` webhook.
- Trigger server-side processing of an uploaded asset file for a specific locale.
REQUIRED after `create_asset` (or after updating an asset's file spec) and BEFORE
`publish_asset`. Response is 204 No Content — processing continues asynchronously;
poll `get_asset` until `fields.file.<locale>.url` appears to confirm completion.
- List content types (schemas) in the specified space's master environment. Companion
to the `ContentManagement.ContentType.publish`, `ContentManagement.ContentType.save`,
and `ContentManagement.ContentType.create` webhooks.
- Retrieve a single content type by its ID from the specified space's master
environment. Use this to fetch the current `sys.version` before any
update/delete/publish/unpublish call.
- Create a content type with a caller-supplied ID (Contentful uses PUT for upsert-by-ID —
there is no POST endpoint). Fires the `ContentManagement.ContentType.create` webhook.
Content types must be activated (via `activate_content_type`) before entries can be
created against them.
- Update an existing content type. Fires the `ContentManagement.ContentType.save` webhook.
Requires X-Contentful-Version optimistic-lock header — Contentful returns 409 on
version mismatch. After update, you typically re-activate via `activate_content_type`
for schema changes to appear on the CDA.
- Permanently delete a content type. Fires the `ContentManagement.ContentType.delete`
webhook. Content type MUST be unpublished first AND have no entries associated —
Contentful rejects deletion otherwise with a 400.
- Activate (publish) a content type so entries can be authored against it and its
schema is exposed on the Content Delivery API. Fires the
`ContentManagement.ContentType.publish` webhook. Requires X-Contentful-Version.
- Deactivate (unpublish) a content type. Fires the
`ContentManagement.ContentType.unpublish` webhook. Existing entries are preserved but
are removed from the CDA and no new entries can be created against the type until it
is re-activated. Fails with 400 if any entries still exist for the type.
- List entries in the specified space's master environment. Fires read-only
against the Contentful CMA — companion to the ContentManagement.Entry.publish,
ContentManagement.Entry.save, and ContentManagement.Entry.create webhooks.
- Retrieve a single entry by its ID from the specified space's master environment.
Use this to fetch the current `sys.version` before any update/delete/publish/unpublish call.
- Create a new entry of the given content type in the specified space's master
environment. Fires the `ContentManagement.Entry.create` webhook. Server generates
the entry ID; response `sys.version` is 1.
- Update an existing entry by ID. Fires the `ContentManagement.Entry.save` webhook.
Requires the X-Contentful-Version optimistic-lock header — Contentful returns 409
on version mismatch.
- Permanently delete an entry by ID. Fires the `ContentManagement.Entry.delete` webhook.
Entry MUST be unpublished first — Contentful rejects deletion of a currently-published
entry with a 400.
- Publish an entry so it becomes available on the Content Delivery API. Fires the
`ContentManagement.Entry.publish` webhook. Requires X-Contentful-Version optimistic-lock
header.
- Unpublish an entry — its draft is retained but the published version is removed from
the Content Delivery API. Fires the `ContentManagement.Entry.unpublish` webhook.
- List all organizations the authenticated user has access to.
- Get details for a specific organization (admin/owner only).
- Update an organization's properties (admin/owner only).
- List all members of an organization.
- Retrieve a single organization membership.
- Update an organization member's role.
- Remove a user from the organization.
- List organization-wide periodic usage metrics. Requires the organization-usage feature on the account's plan; non-eligible accounts return 404 Resource not found.
- List available licenses for the organization.
- Invite a user to join the organization. The invitee receives an email with an acceptance link.
- Retrieve a pending or accepted organization invitation by its identifier.
- List the authenticated user's personal access tokens.
- Retrieve metadata for a specific personal access token.
- Create a new personal access token for the authenticated user.
- Revoke a personal access token, immediately invalidating it.
- List all personal access tokens (PATs) with access to a Contentful organization.
- List all roles in a space.
- Retrieve a single role by ID.
- Create a custom role in a space.
- Update an existing role.
- Permanently delete a role.
- List space-membership records for a space (each item carries the user link, admin flag, and role assignments).
- Retrieve a single space membership by ID.
- Grant an existing organization member access to a space (cannot invite net-new users).
- Update a space membership's roles or admin status.
- Remove a user from a space.
- List combined direct and team-derived members of a space.
- Retrieve a single space member's combined direct and team-derived access.
- List all spaces accessible to the authenticated user.
- Retrieve a single space by ID.
- Create a new space in an organization. Requires the organization to have an available space-creation license; otherwise the provider returns 422 LicenseNotFoundError.
- Update a space's name.
- Permanently delete a space and all of its resources.
- Get add-on allocations for a space. Requires the space add-ons feature on the account's plan; non-eligible accounts return 404 Resource not found.
- Update add-on allocations for a space. Requires the space add-ons feature on the account's plan; non-eligible accounts return 404 Resource not found.
- List license options eligible for a space.
- List per-space periodic usage metrics for an organization. Requires the per-space-usage feature on the account's plan; non-eligible accounts return 404 Resource not found.
- List Team objects (name, description, member count) that have access to a space. For per-team admin status or role assignments use list_team_space_memberships_in_space instead.
- List all teams in an organization.
- Retrieve a single team by ID.
- Create a new team in an organization.
- Update a team's name and description.
- Delete a team from an organization.
- List members of a team.
- List all team memberships across the organization.
- Retrieve a single team membership by ID.
- Add an organization member to a team.
- Remove a member from a team.
- List team-space membership records for a space (each item carries the team link, admin flag, and role assignments).
- Retrieve a single team space membership by ID.
- Grant a team access to a space.
- Update a team's access to a space.
- Revoke a team's access to a space.
- Get the currently authenticated Contentful user.
- List User objects (name, email, avatar, activated state) for everyone with access to a Contentful space. If you need role or admin assignments per user, use list_space_memberships instead.
- Get a single user with access to a Contentful space.
- List all users in a Contentful organization.
- Get a single user in a Contentful organization.
No matching actions