Create a client instance
+Client initialization parameters
+const client = contentfulManagement.createClient({
accessToken: 'myAccessToken'
})
+
+
+Optional
defaults?: DefaultParamsOptional
defaults?: DefaultParamsOptional
type?: "plain"Parameters for endpoint methods that can be paginated are inconsistent, fetchAll
will only
+work with the more common version of supplying the limit, skip, and pageNext parameters via a distinct query
property in the
+parameters.
+ + + +
++ Readme · + Setup · + Migration · + Changelog · + Contributing +
++ + + +
+ +What is Contentful?
+Contentful provides a content infrastructure for digital teams to power content in websites, apps, and devices. Unlike a CMS, Contentful was built to integrate with the modern software stack. It offers a central hub for structured content, powerful management and delivery APIs, and a customizable web app that enable developers and content creators to ship digital products faster.
+Browsers and Node.js:
+Other browsers should also work, but at the moment we're only running automated tests on the browsers and Node.js versions specified above.
+To get started with the Contentful Management JS library you'll need to install it, and then get credentials which will allow you to access your content in Contentful.
+Using npm:
+npm install contentful-management
+
+
+Using yarn:
+yarn add contentful-management
+
+
+For browsers, we recommend to download the library via npm or yarn to ensure 100% availability.
+If you'd like to use a standalone built file you can use the following script tag or download it from jsDelivr, under the dist
directory:
<script src="https://cdn.jsdelivr.net/npm/contentful-management@latest/dist/contentful-management.browser.min.js"></script>
+
+
+It's not recommended to use the above URL for production.
+Using contentful@latest
will always get you the latest version, but you can also specify a specific version number:
<!-- Avoid using the following url for production. You can not rely on its availability. -->
<script src="https://cdn.jsdelivr.net/npm/contentful-management@7.3.0/dist/contentful-management.browser.min.js"></script>
+
+
+The Contentful Management library will be accessible via the contentfulManagement
global variable.
Check the releases page to know which versions are available.
+This library also comes with typings to use with typescript.
+To get content from Contentful, an app should authenticate with an OAuth bearer token.
+If you want to use this library for a simple tool or a local app that you won't redistribute or make available to other users, you can get an API key for the Management API at our Authentication page.
+If you'd like to create an app which would make use of this library but that would be available for other users, where they could authenticate with their own Contentful credentials, make sure to also check out the section about Creating an OAuth Application
+You can use the es6 import with the library as follows
+// import createClient directly
import contentful from 'contentful-management'
const client = contentful.createClient(
{
// This is the access token for this space. Normally you get the token in the Contentful web app
accessToken: 'YOUR_ACCESS_TOKEN',
},
{ type: 'plain' }
)
//....
+
+
+Beginning with contentful-management@7
this library provides a client which exposes all CMA endpoints in a simple flat API surface, as opposed to the waterfall structure exposed by legacy versions of the SDK.
const contentful = require('contentful-management')
const plainClient = contentful.createClient(
{
accessToken: 'YOUR_ACCESS_TOKEN',
},
{ type: 'plain' }
)
const environment = await plainClient.environment.get({
spaceId: '<space_id>',
environmentId: '<environment_id>',
})
const entries = await plainClient.entry.getMany({
spaceId: '123',
environmentId: '',
query: {
skip: 10,
limit: 100,
},
})
// With scoped space and environment
const scopedPlainClient = contentful.createClient(
{
accessToken: 'YOUR_ACCESS_TOKEN',
},
{
type: 'plain',
defaults: {
spaceId: '<space_id>',
environmentId: '<environment_id>',
},
}
)
// entries from '<space_id>' & '<environment_id>'
const entries = await scopedPlainClient.entry.getMany({
query: {
skip: 10,
limit: 100,
},
})
+
+
+You can try and change the above example on Runkit.
+The benefits of using the "plain" version of the client, over the legacy version, are:
+toPlainObject
function call.spaceId
, environmentId
, and organizationId
when initializing the client.
+defaults
and omit specifying these params in actual CMA methods calls.The following code snippet is an example of the legacy client interface, which reads and writes data as a sequence of nested requests:
+const contentful = require('contentful-management')
const client = contentful.createClient({
accessToken: 'YOUR_ACCESS_TOKEN',
})
// Get a space with the specified ID
client.getSpace('spaceId').then((space) => {
// Get an environment within the space
space.getEnvironment('master').then((environment) => {
// Get entries from this environment
environment.getEntries().then((entries) => {
console.log(entries.items)
})
// Get a content type
environment.getContentType('product').then((contentType) => {
// Update its name
contentType.name = 'New Product'
contentType.update().then((updatedContentType) => {
console.log('Update was successful')
})
})
})
})
+
+
+Starting @contentful/app-sdk@4
you can use this client to make requests
+from your apps built for Contentful.
A dedicated Adapter +grants your apps access to the supported space-environment scoped entities without compromising on security as you won't +need to expose a management token, and without coding any additional backend middleware.
+const contentfulApp = require('@contentful/app-sdk')
const contentful = require('contentful-management')
contentfulApp.init((sdk) => {
const cma = contentful.createClient(
{ apiAdapter: sdk.cmaAdapter },
{
type: 'plain',
defaults: {
environmentId: sdk.ids.environmentAlias ?? sdk.ids.environment,
spaceId: sdk.ids.space,
},
}
)
// ...rest of initialization code
})
+
+
+++Please Note
+Requests issued by the App SDK adapter will count towards the same rate limiting quota as the ones made by other APIs +exposed by App SDK (e.g., Space API). Ultimately, they will all fall into the same bucket as the calls performed by +the host app (i.e., Contentful web app, Compose, or Launch).
+
contentful-management
and not contenful-management
¯\_(ツ)_/¯http
- Our library is supplied as node and browser version. Most non-node environments, like React Native, act like a browser. To force using of the browser version, you can require it via: const { createClient } = require('contentful-management/dist/contentful-management.browser.min.js')
To help you get the most out of this library, we've prepared reference documentation, tutorials and other examples that will help you learn and understand how to use this library.
+The createClient
method supports several options you may set to achieve the expected behavior:
contentful.createClient({
... your config here ...
})
+
+
+apiAdapter
is not set)Your CMA access token.
+'api.contentful.com'
)Set the host used to build the request URI's.
+'upload.contentful.com'
)Set the host used to build the upload related request uri's.
+This path gets appended to the host to allow request urls like https://gateway.example.com/contentful/
for custom gateways/proxies.
undefined
)Custom agent to perform HTTP requests. Find further information in the axios request config documentation.
+undefined
)Custom agent to perform HTTPS requests. Find further information in the axios request config documentation.
+{}
)Additional headers to attach to the requests. We add/overwrite the following headers:
+application/vnd.contentful.management.v1+json
sdk contentful-management.js/1.2.3; platform node.js/1.2.3; os macOS/1.2.3
+(Automatically generated)undefined
)Axios proxy configuration. See the axios request config documentation for further information about the supported values.
+true
)By default, this library is retrying requests which resulted in a 500 server error and 429 rate limit response. Set this to false
to disable this behavior.
function (level, data) {}
)Errors and warnings will be logged by default to the node or browser console. Pass your own log handler to intercept here and handle errors, warnings and info on your own.
+function (config) {}
)Interceptor called on every request. Takes Axios request config as an arg. Default does nothing. Pass your own function to log any desired data.
+function (response) {}
)Interceptor called on every response. Takes Axios response object as an arg. Default does nothing. Pass your own function to log any desired data.
+new RestAdapter(configuration)
)An Adapter
+that can be utilized to issue requests. It defaults to a RestAdapter
+initialized with provided configuration.
++Please Note
+The Adapter will take precedence over the other options. Therefore, ensure you're providing the Adapter all the +information it needs to issue the request (e.g., host or auth headers)
+
0
)Maximum number of requests per second.
+1
-30
(fixed number of limit),'auto'
(calculated limit based on your plan),'0%'
- '100%'
(calculated % limit based on your plan)The Contentful's JS library reference documents what objects and methods are exposed by this library, what arguments they expect and what kind of data is returned.
+Most methods also have examples which show you how to use them.
+You can start by looking at the top level contentfulManagement
namespace.
The ContentfulClientAPI
namespace defines the methods at the Client level which allow you to create and get spaces.
The ContentfulSpaceAPI
namespace defines the methods at the Space level which allow you to create and get entries, assets, content types and other possible entities.
The Entry
, Asset
and ContentType
namespaces show you the instance methods you can use on each of these entities, once you retrieve them from the server.
++From version 1.0.0 onwards, you can access documentation for a specific version by visiting
+https://contentful.github.io/contentful-management.js/contentful-management/<VERSION>
Read the Contentful for JavaScript page for Tutorials, Demo Apps, and more information on other ways of using JavaScript with Contentful
+This library is a wrapper around our Contentful Management REST API. Some more specific details such as search parameters and pagination are better explained on the REST API reference, and you can also get a better understanding of how the requests look under the hood.
+This project strictly follows Semantic Versioning by use of semantic-release.
+This means that new versions are released automatically as fixes, features or breaking changes are released.
+You can check the changelog on the releases page.
+We appreciate any help on our repositories. For more details about how to contribute see our CONTRIBUTING.md document.
+This repository is published under the MIT license.
+We want to provide a safe, inclusive, welcoming, and harassment-free space and experience for all participants, regardless of gender identity and expression, sexual orientation, disability, physical appearance, socioeconomic status, body size, ethnicity, nationality, level of experience, age, religion (or lack thereof), or other identity markers.
+ +Optional
tokenRevokes access token
+Object the revoked access token
+Optional
descriptionOptional
policiesDeletes this object on the server.
+Promise for the deletion. It contains no data, but the Promise error case should be handled.
+Sends an update to the server with any changes made to the object's properties
+Object returned from the server with updated changes.
+System metadata
+Token for an app installation in a space environment
+Optional
commentA comment that describes this bundle
+List of all the files that are in this bundle
+System metadata
+Deletes this object on the server.
+Promise for the deletion. It contains no data, but the Promise error case should be handled.
+Deletes this object on the server.
+Promise for the deletion. It contains no data, but the Promise error case should be handled.
+System metadata
+Subscription url that will receive events
+List of topics to subscribe to
+Deletes this object on the server.
+Promise for the deletion. It contains no data, but the Promise error case should be handled.
+Optional
parametersFree-form installation parameters (API limits stringified length to 32KB)
+Deletes this object on the server.
+Promise for the deletion. It contains no data, but the Promise error case should be handled.
+Sends an update to the server with any changes made to the object's properties
+Object returned from the server with updated changes.
+Optional
generatedIf generated, private key is returned
+Base64 PEM
+JSON Web Key
+System metadata
+Deletes this object on the server.
+Promise for the deletion. It contains no data, but the Promise error case should be handled.
+new headers to be included in the request
+System metadata
+The last four characters of the signing secret
+System metadata
+Deletes this object on the server.
+Promise for the deletion. It contains no data, but the Promise error case should be handled.
+Deletes this object on the server.
+Promise for the deletion. It contains no data, but the Promise error case should be handled.
+Optional
description?: { Description for this asset
+File object for this asset
+Optional
details?: Record<string, any>Details for the file, depending on file type (example: image size in bytes, etc)
+Optional
upload?: stringUrl where the file is available to be downloaded from, into the Contentful asset system. After the asset is processed this field is gone.
+Optional
uploadOptional
url?: stringUrl where the file is available at the Contentful media asset system. This field won't be available until the asset is processed.
+Title for this asset
+Optional
metadataArchives the object
+Object returned from the server with updated metadata.
+Deletes this object on the server.
+Promise for the deletion. It contains no data, but the Promise error case should be handled.
+Triggers asset processing after an upload, for the files uploaded to all locales of an asset.
+Optional
options: AssetProcessingForLocaleAdditional options for processing
+Object returned from the server with updated metadata.
+If the asset takes too long to process. If this happens, retrieve the asset again, and if the url property is available, then processing has succeeded. If not, your file might be damaged.
+Triggers asset processing after an upload, for the file uploaded to a specific locale.
+Locale which processing should be triggered for
+Optional
Options: AssetProcessingForLocaleObject returned from the server with updated metadata.
+If the asset takes too long to process. If this happens, retrieve the asset again, and if the url property is available, then processing has succeeded. If not, your file might be damaged.
+Publishes the object
+Object returned from the server with updated metadata.
+Unarchives the object
+Object returned from the server with updated metadata.
+Unpublishes the object
+Object returned from the server with updated metadata.
+Sends an update to the server with any changes made to the object's properties
+Object returned from the server with updated changes.
+A JWT describing a policy; needs to be attached to signed URLs
+A secret key to be used for signing URLs
+The object returned by the BulkActions API
+Optional
errorerror information, if present
+original payload when BulkAction was created
+Performs a new GET request and returns the wrapper BulkAction
+Waits until the BulkAction is in one of the final states (succeeded
or failed
) and returns it.
Optional
options: AsyncActionProcessingOptionsThe object returned by the BulkActions API
+Base interface for all Payload interfaces. Used as part of the MakeRequestOptions to simplify payload definitions.
+Base interface for all Payload interfaces. Used as part of the MakeRequestOptions to simplify payload definitions.
+Base interface for all Payload interfaces. Used as part of the MakeRequestOptions to simplify payload definitions.
+Optional
allowedOptional
apiOptional
defaultOptional
deletedOptional
disabledOptional
itemsOptional
linkOptional
omittedOptional
validationsField used as the main display field for Entries
+All the fields contained in this Content Type
+Optional
metadataDeletes this object on the server.
+Promise for the deletion. It contains no data, but the Promise error case should be handled.
+Gets the editor interface for the object
+Important note: The editor interface only represent a published contentType.
+To get the most recent representation of the contentType make sure to publish it first
Object returned from the server with the current editor interface.
+Gets a snapshot of a contentType
+Id of the snapshot
+Gets all snapshots of a contentType
+Omits and deletes a field if it exists on the contentType. This is a convenience method which does both operations at once and potentially less +safe than the standard way. See note about deleting fields on the Update method.
+Object returned from the server with updated metadata.
+Publishes the object
+Object returned from the server with updated metadata.
+Unpublishes the object
+Object returned from the server with updated metadata.
+Sends an update to the server with any changes made to the object's properties.
+Important note about deleting fields: The standard way to delete a field is with two updates: first omit the property from your responses (set the field attribute "omitted" to true), and then
+delete it by setting the attribute "deleted" to true. See the "Deleting fields" section in the
+API reference for more reasoning. Alternatively,
+you may use the convenience method omitAndDeleteField to do both steps at once.
Object returned from the server with updated changes.
+Optional
assetOptional
assetOptional
dateOptional
enabledOptional
enabledOptional
inOptional
linkOptional
linkOptional
messageOptional
nodesOptional
prohibitOptional
rangeOptional
regexpOptional
sizeOptional
uniqueOptional
pagesOptional
controlsArray of fields and their associated widgetId
+Optional
editorLegacy singular editor override
+Optional
editorArray of editor layout field groups
+Optional
editorsArray of editors. Defaults will be used if property is missing.
+Optional
groupArray of field groups and their associated widgetId
+Optional
sidebarArray of sidebar widgets. Defaults will be used if property is missing.
+Gets a control for a specific field
+control object for specific field
+const contentful = require('contentful-management')
const client = contentful.createClient({
accessToken: '<content_management_api_key>'
})
client.getSpace('<space_id>')
.then((space) => space.getEnvironment('<environment_id>'))
.then((environment) => environment.getContentType('<contentType_id>'))
.then((contentType) => contentType.getEditorInterface())
.then((editorInterface) => {
control = editorInterface.getControlForField('<field-id>')
console.log(control)
})
.catch(console.error)
+
+
+Sends an update to the server with any changes made to the object's properties
+Object returned from the server with updated changes.
+const contentful = require('contentful-management')
const client = contentful.createClient({
accessToken: '<content_management_api_key>'
})
client.getSpace('<space_id>')
.then((space) => space.getEnvironment('<environment_id>'))
.then((environment) => environment.getContentType('<contentType_id>'))
.then((contentType) => contentType.getEditorInterface())
.then((editorInterface) => {
editorInterface.controls[0] = { "fieldId": "title", "widgetId": "singleLine"}
editorInterface.editors = [
{ "widgetId": "custom-widget", "widgetNamespace": "app" }
]
return editorInterface.update()
})
.catch(console.error)
+
+
+Optional
controlsArray of fields and their associated widgetId
+Optional
editorLegacy singular editor override
+Optional
editorArray of editor layout field groups
+Optional
editorsArray of editors. Defaults will be used if property is missing.
+Optional
groupArray of field groups and their associated widgetId
+Optional
sidebarArray of sidebar widgets. Defaults will be used if property is missing.
+Optional
archivedOptional
archivedOptional
archivedOptional
createdOptional
deletedOptional
deletedOptional
deletedOptional
firstOptional
localeOptional
publishedOptional
publishedOptional
publishedOptional
publishedOptional
statusOptional
updatedArchives the object
+Creates a new comment for an entry
+Object representation of the Comment to be created
+Promise for the newly created Comment
+Creates a new task for an entry
+Object representation of the Task to be created
+Promise for the newly created Task
+Deletes this object on the server.
+Promise for the deletion. It contains no data, but the Promise error case should be handled.
+Gets a comment of an entry
+const contentful = require('contentful-management')
+const client = contentful.createClient({ +accessToken: '<content_management_api_key>' +})
+client.getSpace('<space_id>')
+.then((space) => space.getEnvironment('<comment-id>
))
+.then((comment) => console.log(comment))
+.catch(console.error)
+
+
+Gets all comments of an entry
+const contentful = require('contentful-management')
+const client = contentful.createClient({ +accessToken: '<content_management_api_key>' +})
+client.getSpace('<space_id>')
+.then((space) => space.getEnvironment('
+
+
+Gets a snapshot of an entry
+Id of the snapshot
+Gets all snapshots of an entry
+Gets a task of an entry
+const contentful = require('contentful-management')
+const client = contentful.createClient({ +accessToken: '<content_management_api_key>' +})
+client.getSpace('<space_id>')
+.then((space) => space.getEnvironment('<task-id>
))
+.then((task) => console.log(task))
+.catch(console.error)
+
+
+Gets all tasks of an entry
+const contentful = require('contentful-management')
+const client = contentful.createClient({ +accessToken: '<content_management_api_key>' +})
+client.getSpace('<space_id>')
+.then((space) => space.getEnvironment('
+
+
+Checks if entry is archived. This means it's not exposed to the Delivery/Preview APIs.
+Checks if the entry is in draft mode. This means it is not published.
+Checks if the entry is published. A published entry might have unpublished changes
+Checks if the entry is updated. This means the entry was previously published but has unpublished changes.
+Optional
metadataSends an JSON patch to the server with any changes made to the object's properties
+Publishes the object
+Recursively collects references of an entry and their descendants
+Unarchives the object
+Unpublishes the object
+Sends an update to the server with any changes made to the object's properties
+Optional
archivedOptional
archivedOptional
archivedOptional
createdOptional
deletedOptional
deletedOptional
deletedOptional
firstOptional
localeOptional
publishedOptional
publishedOptional
publishedOptional
publishedOptional
statusOptional
updatedDeletes this object on the server.
+Promise for the deletion. It contains no data, but the Promise error case should be handled.
+const contentful = require('contentful-management')
const client = contentful.createClient({
accessToken: '<content_management_api_key>'
})
client.getSpace('<space_id>')
.then((space) => space.getEnvironmentAlias('<environment_alias_id>'))
.then((alias) => {
return alias.delete()
})
.then(() => console.log(`Alias deleted.`))
.catch(console.error)
+
+
+Sends an update to the server with any changes made to the object's properties. Currently, you can only change the id of the alias's underlying environment. See the example below.
+Object returned from the server with updated changes.
+const contentful = require('contentful-management')
const client = contentful.createClient({
accessToken: '<content_management_api_key>'
})
client.getSpace('<space_id>')
.then((space) => space.getEnvironmentAlias('<environment_alias_id>'))
.then((alias) => {
alias.environment.sys.id = '<environment_id>'
return alias.update()
})
.then((alias) => console.log(`alias ${alias.sys.id} updated.`))
.catch(console.error)
+
+
+Link is a reference object to another entity that can be resolved using tools such as contentful-resolve
+Locale code (example: en-us)
+If the content under this locale should be available on the CDA (for public reading)
+If the content under this locale should be available on the CMA (for editing)
+If this is the default locale
+Locale code to fallback to when there is not content for the current locale
+Internal locale code
+Locale name
+If the locale needs to be filled in on entries or not
+Deletes this object on the server.
+Promise for the deletion. It contains no data, but the Promise error case should be handled.
+Sends an update to the server with any changes made to the object's properties
+Object returned from the server with updated changes.
+Optional
headersOptional
paramsOptional
payloadBase interface for all Payload interfaces. Used as part of the MakeRequestOptions to simplify payload definitions.
+Optional
archivedOptional
archivedOptional
archivedOptional
createdOptional
deletedOptional
deletedOptional
deletedOptional
publishedOptional
spaceOptional
statusOptional
updatedDeletes this object on the server. +@example```javascript +const contentful = require('contentful-management')
+const client = contentful.createClient({ +accessToken: '<content_management_api_key>' +})
+client.getOrganization('organization_id') +.then(org => org.getOrganizationMembership('organizationMembership_id')) +.then((organizationMembership) => { +organizationMembership.delete(); +}) +.catch(console.error)
+
+
+
+Sends an update to the server with any changes made to the object's properties
+Object returned from the server with updated changes.
+Optional
tokenRevokes a personal access token
+Object the revoked personal access token
+The object returned by the Releases API
+Publishes a Release and waits until the asynchronous action is completed
+Optional
options: AsyncActionProcessingOptionsUnpublishes a Release and waits until the asynchronous action is completed
+Optional
options: AsyncActionProcessingOptionsUpdates a Release and returns the updated Release object
+Validates a Release and waits until the asynchronous action is completed
+Optional
__namedParameters: { Optional
options?: AsyncActionProcessingOptionsOptional
payload?: ReleaseValidatePayloadThe object returned by the Releases API
+Performs a new GET request and returns the wrapper Release
+Waits until the Release Action has either succeeded or failed
+Optional
options: AsyncActionProcessingOptionsThe object returned by the Releases API
+Optional
actionOptional
limitLimit of how many records are returned in the query result
+Optional
orderOptional
sys.id[in]Find Release Actions by using a comma-separated list of Ids
+Optional
sys.release.sys.id[in]Optional
sys.status[in]Optional
sys.status[nin]Optional
uniqueGet unique results by this field. Currently supports sys.release.sys.id
Base interface for all Payload interfaces. Used as part of the MakeRequestOptions to simplify payload definitions.
+The object returned by the Releases API
+Optional
entities.sys.id[in]Find releases containing the specified, comma-separated entities. Requires entities.sys.linkType
Optional
entities.sys.linkFind releases filtered by the Entity type (Asset, Entry)
+Optional
entities[exists]Filter by empty Releases (exists=false) or Releases with items (exists=true)
+Optional
limitLimit how many records are returned in the result
+Optional
orderOrder releases +Supported values include
+title
, -title
sys.updatedAt
, -sys.updatedAt
sys.createdAt
, -sys.createdAt
Optional
pageIf present, will return results based on a pagination cursor
+Optional
sys.createdComma-separated list of user Ids to find releases by creator
+Optional
sys.id[in]Comma-separated list of Ids to find (inclusion)
+Optional
sys.id[nin]Comma-separated list of ids to exclude from the query
+Optional
sys.status[in]Comma-separated filter (inclusion) by Release status (active, archived)
+Optional
sys.status[nin]Comma-separated filter (exclusion) by Release status (active, archived)
+Optional
title[match]Find releases using full text phrase and term matching
+ResourceLink is a reference object to another entity outside of the current space/environment
+Link to a Contentful function
+System metadata
+Resource Provider type, value is 'function'
+Resource Type defaultFieldMapping
+Resource Type name
+System metadata
+Optional
descriptionPermissions for application sections
+Deletes this object on the server.
+Promise for the deletion. It contains no data, but the Promise error case should be handled.
+Sends an update to the server with any changes made to the object's properties
+Object returned from the server with updated changes.
+Optional
environmentOptional
errorThe Contentful-style error that occurred during execution if sys.status is failed
+Optional
payloadOptional
timezone?: stringA valid IANA timezone Olson identifier
+Deletes this object on the server.
+Promise for the deletion. It contains no data, but the Promise error case should be handled.
+Sends an update to the server with any changes made to the object's properties
+Object returned from the server with updated changes.
+Description of the team
+Name of the team
+System metadata
+Deletes this object on the server.
+Promise for the deletion. It contains no data, but the Promise error case should be handled.
+Sends an update to the server with any changes made to the object's properties
+Object returned from the server with updated changes.
+Is admin
+Organization membership id
+System metadata
+Deletes this object on the server.
+Promise for the deletion. It contains no data, but the Promise error case should be handled.
+Sends an update to the server with any changes made to the object's properties
+Object returned from the server with updated changes.
+Deletes this object on the server.
+Promise for the deletion. It contains no data, but the Promise error case should be handled.
+Sends an update to the server with any changes made to the object's properties
+Object returned from the server with updated changes.
+System metadata
+Field types where an extension can be used
+Extension name
+Optional
parameters?: { Parameter definitions
+Optional
installation?: ParameterDefinition<InstallationParameterType>[]Optional
instance?: ParameterDefinition<ParameterType>[]Optional
sidebar?: booleanControls the location of the extension. If true it will be rendered on the sidebar instead of replacing the field's editing control
+Optional
src?: stringURL where the root HTML document of the extension can be found
+Optional
srcdoc?: stringString representation of the extension (e.g. inline HTML code)
+Optional
parametersValues for installation parameters
+Deletes this object on the server.
+Promise for the deletion. It contains no data, but the Promise error case should be handled.
+Sends an update to the server with any changes made to the object's properties
+Object returned from the server with updated changes.
+Deletes this object on the server.
+Promise for the deletion. It contains no data, but the Promise error case should be handled.
+const contentful = require('contentful-management')
const client = contentful.createClient({
accessToken: '<content_management_api_key>'
})
client.getSpace('<space_id>')
.then((space) => space.getEnvironment('<environment_id>'))
.then((environment) => environment.getUpload('<upload_id>'))
.then((upload) => upload.delete())
.then((upload) => console.log(`upload ${upload.sys.id} updated.`))
.catch(console.error)
+
+
+creates the upload credentials.
+upload credentials for file uploads
+const contentful = require('contentful-management')
const client = contentful.createClient({
accessToken: '<content_management_api_key>'
})
try {
const space = await client.getSpace('<space_id>')
const environment = await space.getEnvironment('<environment_id>')
const upload = await client.uploadCredential.create({
spaceId: space.sys.id,
environmentId: environment.sys.id
})
} catch (error) {
console.error(error)
}
+
+
+Range of usage
+Type of usage
+System metadata
+Unit of usage metric
+Value of the usage
+Usage per day
+Activation flag
+Url to the users avatar
+User confirmation flag
+Email address of the user
+First name of the user
+Last name of the user
+Number of sign ins
+System metadata
+System metadata
+Whether the Webhook is active. If set to false, no calls will be made
+Optional
filtersWebhook filters
+Headers that should be appended to the webhook request
+Optional
httpPassword for basic http auth
+Optional
httpUsername for basic http auth
+Webhook name
+System metadata
+Topics the webhook wants to subscribe to
+Optional
transformationTransformation to apply
+Webhook url
+Deletes this object on the server.
+Promise for the deletion. It contains no data, but the Promise error case should be handled.
+const contentful = require('contentful-management')
const client = contentful.createClient({
accessToken: '<content_management_api_key>'
})
client.getSpace('<space_id>')
.then((space) => space.getWebhook('<webhook_id>'))
.then((webhook) => webhook.delete())
.then((webhook) => console.log(`webhook ${webhook.sys.id} updated.`))
.catch(console.error)
+
+
+Webhook call with specific id. See https://www.contentful.com/developers/docs/references/content-management-api/#/reference/webhook-calls/webhook-call-overviews for more details
+Promise for call details
+const contentful = require('contentful-management')
const client = contentful.createClient({
accessToken: '<content_management_api_key>'
})
client.getSpace('<space_id>')
.then((space) => space.getWebhook('<webhook_id>'))
.then((webhook) => webhook.getCall('<call-id>'))
.then((webhookCall) => console.log(webhookCall))
.catch(console.error)
+
+
+List of the most recent webhook calls. See https://www.contentful.com/developers/docs/references/content-management-api/#/reference/webhook-calls/webhook-call-overviews for more details.
+Promise for list of calls
+const contentful = require('contentful-management')
const client = contentful.createClient({
accessToken: '<content_management_api_key>'
})
client.getSpace('<space_id>')
.then((space) => space.getWebhook('<webhook_id>'))
.then((webhook) => webhook.getCalls())
.then((response) => console.log(response.items)) // webhook calls
.catch(console.error)
+
+
+Overview of the health of webhook calls. See https://www.contentful.com/developers/docs/references/content-management-api/#/reference/webhook-calls/webhook-call-overviews for more details.
+Promise for health info
+const contentful = require('contentful-management')
const client = contentful.createClient({
accessToken: '<content_management_api_key>'
})
client.getSpace('<space_id>')
.then((space) => space.getWebhook('<webhook_id>'))
.then((webhook) => webhook.getHealth())
.then((webhookHealth) => console.log(webhookHealth))
.catch(console.error)
+
+
+Sends an update to the server with any changes made to the object's properties
+Object returned from the server with updated changes.
+const contentful = require('contentful-management')
const client = contentful.createClient({
accessToken: '<content_management_api_key>'
})
client.getSpace('<space_id>')
.then((space) => space.getWebhook('<webhook_id>'))
.then((webhook) => {
webhook.name = 'new webhook name'
return webhook.update()
})
.then((webhook) => console.log(`webhook ${webhook.sys.id} updated.`))
.catch(console.error)
+
+
+Optional
appliesOptional
descriptionOptional
flowOptional
start+ + + +
+ ++ Readme · + Setup · + Migration · + Changelog · + Contributing +
+ ++ + + +
+ + + +# CHANGELOG + +The changelog is automatically updated using +[semantic-release](https://github.com/semantic-release/semantic-release). You +can see it on the [releases page](https://github.com/contentful/contentful-management.js/releases). diff --git a/contentful-management/11.40.3/media/CONTRIBUTING.md b/contentful-management/11.40.3/media/CONTRIBUTING.md new file mode 100644 index 0000000000..e07a6e2add --- /dev/null +++ b/contentful-management/11.40.3/media/CONTRIBUTING.md @@ -0,0 +1,86 @@ + + ++ + + +
+ ++ Readme · + Setup · + Migration · + Changelog · + Contributing +
+ ++ + + +
+ + + +We appreciate any community contributions to this project, whether in the form of issues or Pull Requests. + +This document outlines the we'd like you to follow in terms of commit messages and code style. + +It also explains what to do in case you want to setup the project locally and run tests. + +# Setup + +This project is written in ES2015 and transpiled to ES5 using Babel, to the `dist` directory. This should generally only happen at publishing time, or for testing purposes only. + +Run `npm install` to install all necessary dependencies. When running `npm install` locally, `dist` is not compiled. + +All necessary dependencies are installed under `node_modules` and any necessary tools can be accessed via npm scripts. There is no need to install anything globally. + +When importing local, in develoment code, via `index.js`, this file checks if `dist` exists and uses that. Otherwise, it uses the code from `lib`. + +If you have a `dist` directory, run `npm run clean`. + +Axios, one of the main dependencies is vendored. This generally shouldn't matter, but if you'd like to understand why, check [SETUP.md](SETUP.md) + +# Code style + +This project uses [standard](https://github.com/feross/standard). Install a relevant editor plugin if you'd like. + +Everywhere where it isn't applicable, follow a style similar to the existing code. + +# Commit messages and issues + +This project uses the [Angular JS Commit Message Conventions](https://docs.google.com/document/d/1QrDFcIiPjSLDn3EL15IJygNPiHORgU1_OOAqWjiDU5Y/edit), via semantic-release. See the semantic-release [Default Commit Message Format](https://github.com/semantic-release/semantic-release#default-commit-message-format) section for more details. + +# Running tests + +This project has unit and integration tests. Both of these run on both Node.js and Browser environments. + +Both of these test environments are setup to deal with Babel and code transpiling, so there's no need to worry about that + +- `npm test` runs all three kinds of tests and generates a coverage report +- `npm run test:unit` runs Node.js unit tests without coverage. `npm run test:cover` to run Node.js unit tests with coverage. `npm run test:debug` runs babel-node in debug mode (same as running `node debug`). In order to see an output of the tests in the terminal run `npm run test:unit-watch`. +- `npm run test:integration` runs the integration tests against the Contentful CDA API. Note: these are tricky to run locally since they currently run against a real contentful org. Focus on unit tests during development as integration tests will be run as part of CI/CD. +- `npm run test:browser` runs both the unit and integration tests using Karma against local browsers. +- `npm run test:ci` runs tests in CI +- `npm run test:browser-remote` runs both the unit and integration tests using Karma against Sauce Labs. This is only usable in the CI environment, as it expects the credentials and connection tunnel to be present. + +# Documentation + +Code is documented using Typedoc, and reference documentation is published automatically with each new version. + +- `npm run docs:watch` watches code directory, and rebuilds documentation when anything changes. Useful for documentation writing and development. +- `npm run docs:dev` builds code and builds docs afterwards. Used by `npm run docs:watch`. Code building is required as the documentation is generated from the unminified ES5 compiled sources, rather than the original ES6 sources. You should then open the generated `out/index.html` in your browser. +- `npm run build:docs` builds documentation. +- `npm run docs:publish` builds documentation and publishes it to github pages. + +# Other tasks + +- `npm run clean` removes any built files +- `npm run build` builds vendored files, node package and browser version +- `npm run build:dist` builds ES5 sources from ES6 ones +- `npm run build:standalone` builds unminified and minified sources for browsers diff --git a/contentful-management/11.40.3/media/LICENSE b/contentful-management/11.40.3/media/LICENSE new file mode 100644 index 0000000000..9b0169e76f --- /dev/null +++ b/contentful-management/11.40.3/media/LICENSE @@ -0,0 +1,21 @@ +The MIT License (MIT) + +Copyright (c) 2016 Contentful + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +SOFTWARE. diff --git a/contentful-management/11.40.3/media/MIGRATION.md b/contentful-management/11.40.3/media/MIGRATION.md new file mode 100644 index 0000000000..2496b3dbc7 --- /dev/null +++ b/contentful-management/11.40.3/media/MIGRATION.md @@ -0,0 +1,98 @@ + + ++ + + +
+ ++ Readme · + Setup · + Migration · + Changelog · + Contributing +
+ ++ + + +
+ + + +# Migration to contentful-management.js 1.x from previous versions + +**(May 30th, 2016)** + +contentful.js 1.x was a major rewrite, with some API changes. While the base functionality remains the same, some method names have changed, as well as some internal behaviors. + +The main change you should look out for, is the fact that some of the actions executed on objects you retrieve from the API (Entries, Assets, etc) now have instance methods on them to perform those actions (such as update or delete) rather than methods such as `updateEntry` on the space object. + +This file lists the changes to the API and behavior, and how you should proceed to update your code. + +For more specific details consult the [reference documentation](https://contentful.github.io/contentful-management.js/) for the current version. + +Future releases will have any changes listed in the changelog on the [releases page](https://github.com/contentful/contentful-management.js/releases). + +## Instance methods + +The pre 1.x version of the SDK exposed a top level client object, from which you could create or get spaces. This space object then contained methods to perform all the actions that were possible on that space, such as creating entities (assets, entries, etc), updating them, deleting them, publishing them, etc. + +The new version, works a bit differently. All the methods in the space object which retrieve or create entities (such as `space.createEntry` or `space.getEntry`) retrieve an object for that kind of entity. If you then perform actions such as update, delete, publish/unpublish or archive/unarchive, you perform them directly on methods on the entities. So if you'd get and update an Entry, it would look something like this: + +```js +client.getSpace('spaceid', (space) => { + space.getEntry('entryid', (entry) => { + entry.fields.title['en-US'] = 'new value for title field' + entry.update().then( + (updatedEntry) => { + console.log(updatedEntry.fields.title['en-US']) + }, + (err) => { + console.log('oh no! we failed to update!', err) + } + ) + }) +}) +``` + +Check out the new reference documentation to see what methods exist and on which objects and entities they are available. + +## Format of collection replies + +Before contentful-management.js 1.x, collection replies were essentially JavaScript Arrays with some additional properties (`total`, `skip` and `limit`) added to their prototypes. + +Now, collection replies are Objects, with those same properties, and an additional `items` property containing an array with all the items returned. This is more similar to what is actually returned from the REST API. + +## Class removal + +Before contentful-management.js 1.x, the entities returned from the API such as Entries or Content Types were wrapped in prototype based classes. + +From contentful-management.js 1.x this is not the case anymore. + +The objects returned by the promises are now JavaScript Objects, which contain the relevant data and some helper methods. + +You can get a plain version of this object with only the data by using the `toPlainObject()` method. + +Also note that Date fields such as `sys.createdAt` are not turned into JavaScript `Date` objects anymore, and are now plain ISO-8601 strings. + +## New features + +Some new features were also added to this version: + +- Status methods, such as `isPublished` or `isArchived` +- Asset processing wait + - After creating an asset, it's necessary to call processing on this asset's file so that the file gets properly processed on Contentful's backend systems. In order to do this there are now two separate calls, `processForLocale` and `processForAllLocales`. + - In the older SDK, the only way to know if an asset was ready would be to retrieve the asset again and check if the `upload` property had been removed and if an `url` property was now available. + - The processing calls now do this for you on the background, so the promise only gets resolved when a successful verification call occurs. +- New API endpoints: + - Webhooks + - Roles + - Space Memberships + - API Keys diff --git a/contentful-management/11.40.3/media/README.md b/contentful-management/11.40.3/media/README.md new file mode 100644 index 0000000000..00e605ebf5 --- /dev/null +++ b/contentful-management/11.40.3/media/README.md @@ -0,0 +1,451 @@ + + ++ + + +
+ ++ Readme · + Setup · + Migration · + Changelog · + Contributing +
+ ++ + + +
+ + + +## Introduction + +[![Build Status](https://circleci.com/gh/contentful/contentful-management.js.svg?style=svg)](https://circleci.com/gh/contentful/contentful-management.js) +[![npm](https://img.shields.io/npm/v/contentful-management.svg)](https://www.npmjs.com/package/contentful-management) +[![semantic-release](https://img.shields.io/badge/%20%20%F0%9F%93%A6%F0%9F%9A%80-semantic--release-e10079.svg)](https://github.com/semantic-release/semantic-release) +[![npm downloads](https://img.shields.io/npm/dm/contentful-management.svg)](http://npm-stat.com/charts.html?package=contentful-management) +[![gzip bundle size](http://img.badgesize.io/https://unpkg.com/contentful-management/dist/contentful-management.browser.min.js?compression=gzip)](https://unpkg.com/contentful-management/dist/contentful-management.browser.min.js) + +**What is Contentful?** + +[Contentful](https://www.contentful.com) provides a content infrastructure for digital teams to power content in websites, apps, and devices. Unlike a CMS, Contentful was built to integrate with the modern software stack. It offers a central hub for structured content, powerful management and delivery APIs, and a customizable web app that enable developers and content creators to ship digital products faster. + ++ + + +
+ ++ Readme · + Setup · + Migration · + Changelog · + Contributing +
+ ++ + + +
+ + + +# Setup + +Details and notes about the build process and setup + +## Stop building on prepublish when running npm install locally + +``` +"prepublish": "in-publish && npm run build || not-in-publish", +``` + +See https://www.npmjs.com/package/in-publish and https://medium.com/greenkeeper-blog/what-is-npm-s-prepublish-and-why-is-it-so-confusing-a948373e6be1#.u5ht8hn77 + +## Vendored axios + +`index.js` is the entry point for the node.js package, and it requires a vendored version of Axios from the [contentful-sdk-core](https://github.com/contentful/contentful-sdk-core) package. + +`browser.js` is the entry point for the CommonJS package when required from a browser aware environment (webpack or browserify) and for the standalone `browser-dist` build which is generated with webpack. This version requires a different vendored version of Axios which contains no code that isn't necessary for browsers. diff --git a/contentful-management/11.40.3/media/contentful-icon.png b/contentful-management/11.40.3/media/contentful-icon.png new file mode 100644 index 0000000000000000000000000000000000000000..c1361790bfa014341948dfb5ed01dc8645e7674b GIT binary patch literal 18823 zcmV)fK&8KlP)Hs)9M3
zG6dcv65s~+cUy0XPNI7U+*h$g*TVIChad~4VzcG?PlaV~gI&LG3sHn@iEC_Gj%me2
z)#(+$%mh>+P4nrQ*|>c+2AytugwfA_nX#{4OZ~ias9$s*mE(^?mMujpaohVyjU~N^
z_3r!2MnOhU_ECY_=SoAfSH>HdJ$q^0^8jPtxSr&`joHE}{eAW#z9Maorj7VC#!5`O
zZ3j9w?rwhSNjVD%E@eFiegN!n$J)lf5}XWVcGO+KoxmAEifr*lNC0(1aMW+Zf&YQV
zw{0%9oAuhP(6vBi7BL~m+uv>wpB54DrJBta 1Ng4{yUi9af~ww$LQd>1jynHk Contentful Management API SDK. Allows you to create instances of a client
+with access to the Contentful Content Management API. System metadata Token for an app installation in a space environment Deletes this object on the server. Promise for the deletion. It contains no data, but the Promise error case should be handled. System metadata Human readable description of the action Human readable name for the action System metadata Type of the action, defaults to endpoint if not provided
+endpoint: action is sent to specified URL
+function: deprecated, use function-invocation instead
+function-invocation: action invokes a contentful function Url that will be called when the action is invoked A comment that describes this bundle List of all the files that are in this bundle System metadata Link to an AppBundle Locations where the app can be installed App name Instance parameter definitions URL where the root HTML document of the app can be found System metadata System metadata Subscription url that will receive events List of topics to subscribe to Free-form installation parameters (API limits stringified length to 32KB) If generated, private key is returned Base64 PEM JSON Web Key System metadata new headers to be included in the request System metadata The last four characters of the signing secret System metadata A JWT describing a policy; needs to be attached to signed URLs A secret key to be used for signing URLs Description for this asset File object for this asset Details for the file, depending on file type (example: image size in bytes, etc) Url where the file is available to be downloaded from, into the Contentful asset system. After the asset is processed this field is gone. Url where the file is available at the Contentful media asset system. This field won't be available until the asset is processed. Title for this asset Field used as the main display field for Entries All the fields contained in this Content Type JSON Web Token The body for the call Toggle for automatic private key generation JSON Web Key, required if generate is falsy optional stringified body of the request optional headers of the request the request method the path of the request method A 64 character matching the regular expression /^[0-9a-zA-Z+/=_-]+$/ (required) UNIX timestamp in the future (but not more than 48 hours from now) Array of fields and their associated widgetId Legacy singular editor override Array of editor layout field groups Array of editors. Defaults will be used if property is missing. Array of field groups and their associated widgetId Array of sidebar widgets. Defaults will be used if property is missing. System meta data Name of the environment System metadata String will be in ISO8601 datetime format e.g. 2013-06-26T13:57:24Z Locale code (example: en-us) If the content under this locale should be available on the CDA (for public reading) If the content under this locale should be available on the CMA (for editing) If this is the default locale Locale code to fallback to when there is not content for the current locale Internal locale code Locale name If the locale needs to be filled in on entries or not Role status System metadata Name System metadata Link to a Contentful function System metadata Resource Provider type, value is 'function' Resource Type defaultFieldMapping Resource Type name System metadata Permissions for application sections The Contentful-style error that occurred during execution if sys.status is failed A valid IANA timezone Olson identifier an ISO8601 date string representing when an action was moved to canceled an ISO8601 date string representing when an action was updated User is an admin Array of Role Links Is admin Organization membership id System metadata Description of the team Name of the team System metadata Is admin Roles System metadata System metadata Field types where an extension can be used Extension name Parameter definitions Controls the location of the extension. If true it will be rendered on the sidebar instead of replacing the field's editing control URL where the root HTML document of the extension can be found String representation of the extension (e.g. inline HTML code) Values for installation parameters System metadata System metadata Range of usage Type of usage System metadata Unit of usage metric Value of the usage Usage per day Activation flag Url to the users avatar User confirmation flag Email address of the user First name of the user Last name of the user Number of sign ins System metadata System metadata Whether the Webhook is active. If set to false, no calls will be made Webhook filters Headers that should be appended to the webhook request Password for basic http auth Username for basic http auth Webhook name System metadata Topics the webhook wants to subscribe to Transformation to apply Webhook url Order workflows by Find workflows containing the specified, comma-separated entities. Requires Find workflows filtered by the Entity type (Entry) Find workflows changelog entries containing the specified, comma-separated entities. Requires Find workflows changelog entries filtered by the Entity type (Entry) workflow.sys.id is optional so all past workflows can be found Represents the state of the BulkAction Represents the state of the BulkAction BulkAction failed to complete (terminal state) BulkAction has been started and pending completion BulkAction was completed successfully (terminal state) Create a client instance Create a client instance Client initialization parameters Parameters for endpoint methods that can be paginated are inconsistent, Parameters for endpoint methods that can be paginated are inconsistent,
@@ -228,4 +228,4 @@ This repository is published under the MIT license. We want to provide a safe, inclusive, welcoming, and harassment-free space and experience for all participants, regardless of gender identity and expression, sexual orientation, disability, physical appearance, socioeconomic status, body size, ethnicity, nationality, level of experience, age, religion (or lack thereof), or other identity markers. Revokes access token Revokes access token Object the revoked access token Sends an update to the server with any changes made to the object's properties System metadata Token for an app installation in a space environment Token for an app installation in a space environment A comment that describes this bundle List of all the files that are in this bundle System metadata List of all the files that are in this bundle System metadata System metadata Subscription url that will receive events List of topics to subscribe to Subscription url that will receive events List of topics to subscribe to Free-form installation parameters (API limits stringified length to 32KB) Sends an update to the server with any changes made to the object's properties Sends an update to the server with any changes made to the object's properties Object returned from the server with updated changes. JSON Web Key System metadata new headers to be included in the request System metadata System metadata The last four characters of the signing secret System metadata Url where the file is available to be downloaded from, into the Contentful asset system. After the asset is processed this field is gone. Url where the file is available at the Contentful media asset system. This field won't be available until the asset is processed. Title for this asset Archives the object Triggers asset processing after an upload, for the files uploaded to all locales of an asset. Triggers asset processing after an upload, for the files uploaded to all locales of an asset. Additional options for processing Object returned from the server with updated metadata. If the asset takes too long to process. If this happens, retrieve the asset again, and if the url property is available, then processing has succeeded. If not, your file might be damaged. Triggers asset processing after an upload, for the file uploaded to a specific locale. Triggers asset processing after an upload, for the file uploaded to a specific locale. Locale which processing should be triggered for Object returned from the server with updated metadata. If the asset takes too long to process. If this happens, retrieve the asset again, and if the url property is available, then processing has succeeded. If not, your file might be damaged. Publishes the object Unarchives the object Unpublishes the object Sends an update to the server with any changes made to the object's properties`D5`7NPrImD6`zs
contentful-management.js - v11.40.3
Index
Namespaces
Enumerations
Classes
Interfaces
Type Aliases
Variables
Functions
Namespace editorInterfaceDefaults
Type Alias AccessTokenProp
name: string;
revokedAt: null | string;
scopes: "content_management_manage"[];
sys: AccessTokenSysProps;
token?: string;
}Type Alias AnnotationAssignment
parameters?: Record<string, string | number | boolean>;
}Type Alias ApiKeyProps
accessToken: string;
description?: string;
environments: {
sys: MetaLinkProps;
}[];
name: string;
policies?: {
action: string;
effect: string;
}[];
preview_api_key: {
sys: MetaLinkProps;
};
sys: MetaSysProps;
}Type Alias AppAccessTokenProps
sys: AppAccessTokenSys;
token: string;
}Type declaration
sys: AppAccessTokenSys
token: string
Type Alias AppAction
Type declaration
delete:function
Returns Promise<void>
Example: ```javascript
+const contentful = require('contentful-management')
+
+const client = contentful.createClient({
+ accessToken: '<content_management_api_key>'
+})
+
+client.getOrganization('<org_id>')
+.then((org) => org.getAppDefinition('<app_def_id>'))
+.then((appDefinition) => appDefinition.getAppAction('<app-action-id>'))
+.then((appAction) => appAction.delete())
+.catch(console.error)
+```
Type Alias AppActionCallProps
sys: AppActionCallSys;
}Type declaration
sys: AppActionCallSys
Type Alias AppActionCategoryProps
description: string;
name: string;
parameters?: AppActionParameterDefinition[];
sys: {
id: AppActionCategoryType;
type: "AppActionCategory";
version: string;
};
}Type Alias AppActionCategoryType
Type Alias AppActionParameterDefinition
Type Alias AppActionProps
description?: string;
name: string;
sys: AppActionSys;
type?: AppActionType;
url: string;
}Type declaration
Optional
description?: stringname: string
sys: AppActionSys
Optional
type?: AppActionTypeurl: string
Type Alias AppActionType
Type Alias AppBundleFile
md5: string;
name: string;
size: number;
}Type Alias AppBundleProps
Type declaration
Optional
comment?: stringfiles: AppBundleFile[]
sys: AppBundleSys
Type Alias AppDefinition
Type Alias AppDefinitionProps
bundle?: Link<"AppBundle">;
locations?: AppLocation[];
name: string;
parameters?: {
installation?: ParameterDefinition<InstallationParameterType>[];
instance?: ParameterDefinition[];
};
src?: string;
sys: BasicMetaSysProps & {
organization: SysLink;
shared: boolean;
};
}Type declaration
Optional
bundle?: Link<"AppBundle">Optional
locations?: AppLocation[]name: string
Optional
parameters?: {
installation?: ParameterDefinition<InstallationParameterType>[];
instance?: ParameterDefinition[];
}Optional
installation?: ParameterDefinition<InstallationParameterType>[]Optional
instance?: ParameterDefinition[]Optional
src?: stringsys: BasicMetaSysProps & {
organization: SysLink;
shared: boolean;
}Type Alias AppEventSubscriptionProps
sys: AppEventSubscriptionSys;
targetUrl: string;
topics: string[];
}Type declaration
sys: AppEventSubscriptionSys
target
topics: string[]
Type Alias AppInstallationProps
parameters?: FreeFormParameters;
sys: Omit<BasicMetaSysProps, "id"> & {
appDefinition: SysLink;
environment: SysLink;
space: SysLink;
};
}Type declaration
Optional
parameters?: FreeFormParameterssys: Omit<BasicMetaSysProps, "id"> & {
appDefinition: SysLink;
environment: SysLink;
space: SysLink;
}Type Alias AppKeyProps
generated?: {
privateKey: string;
};
jwk: JWK;
sys: AppKeySys;
}Type declaration
Optional
generated?: {
privateKey: string;
}private
jwk: JWK
sys: AppKeySys
Type Alias AppLocation
Type Alias AppSignedRequestProps
additionalHeaders: {
x-contentful-environment-id: string;
x-contentful-signature: string;
x-contentful-signed-headers: string;
x-contentful-space-id: string;
x-contentful-timestamp: string;
x-contentful-user-id: string;
};
sys: AppSignedRequestSys;
}Type declaration
additional
x-contentful-environment-id: string;
x-contentful-signature: string;
x-contentful-signed-headers: string;
x-contentful-space-id: string;
x-contentful-timestamp: string;
x-contentful-user-id: string;
}x-
x-
x-
x-
x-
x-
sys: AppSignedRequestSys
Type Alias AppSigningSecretProps
redactedValue: string;
sys: AppSigningSecretSys;
}Type declaration
redacted
sys: AppSigningSecretSys
Type Alias AppUploadProps
Type Alias AssetKeyProps
policy: string;
secret: string;
}Type declaration
policy: string
secret: string
Type Alias AssetProps
fields: {
description?: {
[key: string]: string;
};
file: {
[key: string]: {
contentType: string;
details?: Record<string, any>;
fileName: string;
upload?: string;
uploadFrom?: Record<string, any>;
url?: string;
};
};
title: {
[key: string]: string;
};
};
metadata?: MetadataProps;
sys: EntityMetaSysProps;
}Type declaration
fields: {
description?: {
[key: string]: string;
};
file: {
[key: string]: {
contentType: string;
details?: Record<string, any>;
fileName: string;
upload?: string;
uploadFrom?: Record<string, any>;
url?: string;
};
};
title: {
[key: string]: string;
};
}Optional
description?: {
[key: string]: string;
}[key: string]: string
file: {
[key: string]: {
contentType: string;
details?: Record<string, any>;
fileName: string;
upload?: string;
uploadFrom?: Record<string, any>;
url?: string;
};
}[key: string]: {
contentType: string;
details?: Record<string, any>;
fileName: string;
upload?: string;
uploadFrom?: Record<string, any>;
url?: string;
}content
Optional
details?: Record<string, any>file
Optional
upload?: stringOptional
uploadOptional
url?: stringtitle: {
[key: string]: string;
}[key: string]: string
Optional
metadata?: MetadataPropssys: EntityMetaSysProps
Type Alias BulkActionPayload
Type Alias BulkActionType
Type Alias ClientAPI
Type Alias CommentProps
body: string;
status: CommentStatus;
sys: CommentSysProps;
}Type Alias ContentTypeMetadata
annotations?: RequireAtLeastOne<{
ContentType?: AnnotationAssignment[];
ContentTypeField?: Record<string, AnnotationAssignment[]>;
}, "ContentType" | "ContentTypeField">;
taxonomy?: (Link<"TaxonomyConcept"> | Link<"TaxonomyConceptScheme">)[];
}Type Alias ContentTypeProps
description: string;
displayField: string;
fields: ContentFields[];
metadata?: ContentTypeMetadata;
name: string;
sys: BasicMetaSysProps & {
environment: SysLink;
firstPublishedAt?: string;
publishedCounter?: number;
publishedVersion?: number;
space: SysLink;
};
}Type declaration
description: string
display
fields: ContentFields[]
Optional
metadata?: ContentTypeMetadataname: string
sys: BasicMetaSysProps & {
environment: SysLink;
firstPublishedAt?: string;
publishedCounter?: number;
publishedVersion?: number;
space: SysLink;
}Type Alias CreateApiKeyProps
Type Alias CreateAppAccessTokenProps
jwt: string;
}Type declaration
jwt: string
Type Alias CreateAppActionCallProps
parameters: {
[key: string]: any;
};
}Type declaration
parameters: {
[key: string]: any;
}[key: string]: any
Type Alias CreateAppActionProps
description?: string;
name: string;
type?: AppActionType;
url: string;
}Type Alias CreateAppBundleProps
actions?: ActionManifestProps[];
appUploadId: string;
comment?: string;
functions?: FunctionManifestProps[];
}Type Alias CreateAppDefinitionProps
Type Alias CreateAppEventSubscriptionProps
Type Alias CreateAppInstallationProps
Type Alias CreateAppKeyProps
generate?: boolean;
jwk?: JWK;
}Type declaration
Optional
generate?: booleanOptional
jwk?: JWKType Alias CreateAppSignedRequestProps
body?: string;
headers?: Record<string, string>;
method:
| "GET"
| "PUT"
| "POST"
| "DELETE"
| "PATCH"
| "HEAD";
path: string;
}Type declaration
Optional
body?: stringOptional
headers?: Record<string, string>method:
| "GET"
| "PUT"
| "POST"
| "DELETE"
| "PATCH"
| "HEAD"path: string
Type Alias CreateAppSigningSecretProps
value: string;
}Type declaration
value: string
Type Alias CreateAssetKeyProps
expiresAt: number;
}Type declaration
expires
Type Alias CreateAssetProps
Type Alias CreateCommentProps
Type Alias CreateConceptProps
Type Alias CreateConceptSchemeProps
Type Alias CreateContentTypeProps
Type Alias CreateEntryProps<TFields>
Type Parameters
Type Alias CreateEnvironmentAliasProps
Type Alias CreateEnvironmentProps
Type Alias CreateEnvironmentTemplateProps
Type Alias CreateLocaleProps
| "optional"
| "contentManagementApi"
| "default"
| "contentDeliveryApi">, "internal_code">Type Alias CreateOrganizationInvitationProps
Type Alias CreatePATProps
Type Alias CreatePersonalAccessTokenProps
expiresIn?: number;
}Type Alias CreateRoleProps
Type Alias CreateSpaceMembershipProps
Type Alias CreateTagProps
Type Alias CreateTaskProps
Type Alias CreateTeamMembershipProps
Type Alias CreateTeamProps
Type Alias CreateTeamSpaceMembershipProps
Type Alias CreateUIExtensionProps
extension: RequireExactlyOne<SetRequired<UIExtensionProps["extension"], "name" | "fieldTypes" | "sidebar">, "src" | "srcdoc">;
}Type Alias CreateWebhooksProps
Type Alias CreateWithResponseParams
Type Alias CreateWorkflowDefinitionParams
Type Alias CreateWorkflowDefinitionProps
steps: CreateWorkflowStepProps[];
}Type Alias CreateWorkflowProps
entity: Link<"Entry">;
workflowDefinition: Link<"WorkflowDefinition">;
}Type Alias CreateWorkflowStepProps
Type Alias DefinedParameters
Type Alias DeleteCommentParams
Type Alias DeleteConceptParams
Type Alias DeleteConceptSchemeParams
Type Alias DeleteWorkflowDefinitionParams
Type Alias DeleteWorkflowParams
Type Alias EditorInterfaceProps
controls?: Control[];
editor?: Editor;
editorLayout?: FieldGroupItem[];
editors?: Editor[];
groupControls?: GroupControl[];
sidebar?: SidebarItem[];
sys: MetaSysProps & {
contentType: {
sys: MetaLinkProps;
};
environment: {
sys: MetaLinkProps;
};
space: {
sys: MetaLinkProps;
};
};
}Type declaration
Optional
controls?: Control[]Optional
editor?: EditorOptional
editorOptional
editors?: Editor[]Optional
groupOptional
sidebar?: SidebarItem[]sys: MetaSysProps & {
contentType: {
sys: MetaLinkProps;
};
environment: {
sys: MetaLinkProps;
};
space: {
sys: MetaLinkProps;
};
}Type Alias EditorLayoutItem
Type Alias EntryProps<T>
Type Parameters
Type Alias Environment
Type Alias EnvironmentAliasProps
environment: {
sys: MetaLinkProps;
};
sys: BasicMetaSysProps & {
space: SysLink;
};
}Type declaration
environment: {
sys: MetaLinkProps;
}sys: MetaLinkProps
sys: BasicMetaSysProps & {
space: SysLink;
}Type Alias EnvironmentProps
name: string;
sys: EnvironmentMetaSys;
}Type declaration
name: string
sys: EnvironmentMetaSys
Type Alias EnvironmentTemplate
Type Alias EnvironmentTemplateInstallation
Type Alias EnvironmentTemplateInstallationProps
sys: BasicMetaSysProps & {
completedAt?: ISO8601Timestamp;
createdAt: ISO8601Timestamp;
createdBy: Link<"User" | "AppDefinition">;
environment: Link<"Environment">;
errors?: JsonArray;
space: Link<"Space">;
status: EnvironmentTemplateInstallationStatus;
template: VersionedLink<"Template">;
type: "EnvironmentTemplateInstallation";
updatedAt: ISO8601Timestamp;
updatedBy: Link<"User" | "AppDefinition">;
version: number;
};
}Type Alias EnvironmentTemplateInstallationStatus
Type Alias EnvironmentTemplateParams
environmentId: string;
environmentTemplateId: string;
spaceId: string;
}Type Alias EnvironmentTemplateProps
description?: string;
entities: {
contentTypeTemplates: ContentTypeTemplateProps[];
editorInterfaceTemplates: EditorInterfaceTemplateProps[];
};
name: string;
sys: BasicMetaSysProps & {
organization: Link<"Organization">;
version: number;
};
versionDescription?: string;
versionName: string;
}Type Alias FieldType
| {
type: "Symbol";
}
| {
type: "Text";
}
| {
type: "RichText";
}
| {
type: "Integer";
}
| {
type: "Number";
}
| {
type: "Date";
}
| {
type: "Boolean";
}
| {
type: "Object";
}
| {
type: "Location";
}
| {
linkType: "Asset";
type: "Link";
}
| {
linkType: "Entry";
type: "Link";
}
| {
linkType: string;
type: "ResourceLink";
}
| {
items: {
type: "Symbol";
};
type: "Array";
}
| {
items: {
linkType: "Entry";
type: "Link";
};
type: "Array";
}
| {
items: {
linkType: string;
type: "ResourceLink";
};
type: "Array";
}
| {
items: {
linkType: "Asset";
type: "Link";
};
type: "Array";
}Type Alias FreeFormParameters
| Record<string, any>
| any[]
| number
| string
| booleanType Alias FunctionProps
accepts: string[];
allowNetworks?: string[];
description: string;
name: string;
path: string;
sys: {
appDefinition: Link<"AppDefinition">;
createdAt: string;
createdBy: Link<"User">;
id: string;
organization: Link<"Organization">;
type: "Function";
updatedAt: string;
updatedBy: Link<"User">;
};
}Type Alias GetAppActionCallDetailsParams
Type Alias GetAppActionCallParams
Type Alias GetAppActionParams
Type Alias GetAppActionsForEnvParams
Type Alias GetAppBundleParams
Type Alias GetAppDefinitionParams
Type Alias GetAppInstallationParams
Type Alias GetAppInstallationsForOrgParams
Type Alias GetAppKeyParams
Type Alias GetAppUploadParams
Type Alias GetBulkActionParams
Type Alias GetCommentParams
Type Alias GetCommentParentEntityParams
parentEntityId: string;
parentEntityReference?: string;
parentEntityType: "ContentType";
} | {
parentEntityId: string;
parentEntityReference?: string;
parentEntityType: "Entry";
} | {
parentEntityId: string;
parentEntityType: "Workflow";
parentEntityVersion?: number;
})Type Alias GetConceptDescendantsParams
conceptId: string;
} & {
query?: {
depth?: number;
pageUrl?: string;
};
}Type Alias GetConceptParams
Type Alias GetConceptSchemeParams
Type Alias GetContentTypeParams
Type Alias GetEditorInterfaceParams
Type Alias GetEntryParams
Type Alias GetEnvironmentTemplateParams
Type Alias GetExtensionParams
Type Alias GetManyCommentsParams
status?: CommentStatus;
}Type Alias GetManyConceptParams
query?: {
pageUrl?: string;
} | {
conceptScheme?: string;
query?: string;
} & BasicCursorPaginationOptions & Omit<PaginationQueryOptions, "skip">;
}Type Alias GetManyConceptSchemeParams
query?: {
pageUrl?: string;
} | {
query?: string;
} & BasicCursorPaginationOptions & Omit<PaginationQueryOptions, "skip">;
}Type Alias GetOrganizationMembershipParams
Type Alias GetOrganizationParams
organizationId: string;
}Type Alias GetReleaseParams
Type Alias GetResourceParams
Type Alias GetResourceProviderParams
Type Alias GetResourceTypeParams
Type Alias GetSnapshotForContentTypeParams
Type Alias GetSnapshotForEntryParams
Type Alias GetSpaceEnvAliasParams
Type Alias GetSpaceEnvironmentParams
environmentId: string;
spaceId: string;
}Type Alias GetSpaceEnvironmentUploadParams
Type Alias GetSpaceMembershipProps
Type Alias GetSpaceParams
spaceId: string;
}Type Alias GetTagParams
Type Alias GetTaskParams
Type Alias GetTeamMembershipParams
Type Alias GetTeamParams
organizationId: string;
teamId: string;
}Type Alias GetTeamSpaceMembershipParams
Type Alias GetUIConfigParams
Type Alias GetUserUIConfigParams
Type Alias GetWebhookCallDetailsUrl
Type Alias GetWebhookParams
Type Alias GetWorkflowDefinitionParams
Type Alias GetWorkflowParams
Type Alias Hint
fieldId: string;
operation: "renameFieldId";
previousFieldId: string;
}Type Alias ISO8601Timestamp
Type Alias IconType
Type Alias InstallationParameterType
Type Alias KeyValueMap
Type Alias LocaleProps
code: string;
contentDeliveryApi: boolean;
contentManagementApi: boolean;
default: boolean;
fallbackCode: string | null;
internal_code: string;
name: string;
optional: boolean;
sys: BasicMetaSysProps & {
environment: SysLink;
space: SysLink;
};
}Type declaration
code: string
content
content
default: boolean
fallback
internal_
name: string
optional: boolean
sys: BasicMetaSysProps & {
environment: SysLink;
space: SysLink;
}Type Alias Organization
Type Alias OrganizationInvitationProps
email: string;
firstName: string;
lastName: string;
role: string;
sys: MetaSysProps & {
invitationUrl: string;
organizationMembership: {
sys: MetaLinkProps;
};
status: string;
user: Record<string, any> | null;
};
}Type Alias OrganizationMembershipProps
role: string;
status: boolean;
sys: MetaSysProps & {
user: {
sys: MetaLinkProps;
};
};
}Type declaration
role: string
status: boolean
sys: MetaSysProps & {
user: {
sys: MetaLinkProps;
};
}Type Alias OrganizationProp
Type Alias OrganizationProps
Type declaration
name: string
sys: MetaSysProps
Type Alias PaginationQueryParams
Type Alias ParameterOption
[key: string]: string;
}Type Alias ParameterType
| "Boolean"
| "Symbol"
| "Number"
| "Enum"Type Alias PersonalAccessTokenProp
Type Alias PersonalAccessTokenProps
name: string;
revokedAt: null | string;
scopes: "content_management_manage"[];
sys: MetaSysProps & {
expiresAt?: string;
};
token?: string;
}Type Alias PlainClientAPI
accessToken: {
createPersonalAccessToken(rawData: CreatePATProps, headers?: Partial<RawAxiosHeaders & {
Accept: AxiosHeaderValue;
Authorization: AxiosHeaderValue;
Content-Encoding: AxiosHeaderValue;
Content-Length: AxiosHeaderValue;
User-Agent: AxiosHeaderValue;
} & {
Content-Type: ContentType;
}>): Promise<AccessTokenProp>;
get(params: OptionalDefaults<{
tokenId: string;
}>): Promise<AccessTokenProp>;
getMany(params: OptionalDefaults<QueryParams>): Promise<CollectionProp<AccessTokenProp>>;
getManyForOrganization(params: OptionalDefaults<GetOrganizationParams & QueryParams>): Promise<CollectionProp<AccessTokenProp>>;
revoke(params: OptionalDefaults<{
tokenId: string;
}>): Promise<AccessTokenProp>;
};
apiKey: {
create(params: OptionalDefaults<GetSpaceParams>, data: CreateApiKeyProps, headers?: Partial<RawAxiosHeaders & {
Accept: AxiosHeaderValue;
Authorization: AxiosHeaderValue;
Content-Encoding: AxiosHeaderValue;
Content-Length: AxiosHeaderValue;
User-Agent: AxiosHeaderValue;
} & {
Content-Type: ContentType;
}>): Promise<ApiKeyProps>;
createWithId(params: OptionalDefaults<GetSpaceParams & {
apiKeyId: string;
}>, data: CreateApiKeyProps, headers?: Partial<RawAxiosHeaders & {
Accept: AxiosHeaderValue;
Authorization: AxiosHeaderValue;
Content-Encoding: AxiosHeaderValue;
Content-Length: AxiosHeaderValue;
User-Agent: AxiosHeaderValue;
} & {
Content-Type: ContentType;
}>): Promise<ApiKeyProps>;
delete(params: OptionalDefaults<GetSpaceParams & {
apiKeyId: string;
}>): Promise<any>;
get(params: OptionalDefaults<GetSpaceParams & {
apiKeyId: string;
}>): Promise<ApiKeyProps>;
getMany(params: OptionalDefaults<GetSpaceParams & QueryParams>): Promise<CollectionProp<ApiKeyProps>>;
update(params: OptionalDefaults<GetSpaceParams & {
apiKeyId: string;
}>, rawData: ApiKeyProps, headers?: Partial<RawAxiosHeaders & {
Accept: AxiosHeaderValue;
Authorization: AxiosHeaderValue;
Content-Encoding: AxiosHeaderValue;
Content-Length: AxiosHeaderValue;
User-Agent: AxiosHeaderValue;
} & {
Content-Type: ContentType;
}>): Promise<ApiKeyProps>;
};
appAccessToken: AppAccessTokenPlainClientAPI;
appAction: AppActionPlainClientAPI;
appActionCall: AppActionCallPlainClientAPI;
appBundle: AppBundlePlainClientAPI;
appDefinition: AppDefinitionPlainClientAPI;
appDetails: AppDetailsPlainClientAPI;
appEventSubscription: AppEventSubscriptionPlainClientAPI;
appInstallation: AppInstallationPlainClientAPI;
appKey: AppKeyPlainClientAPI;
appSignedRequest: AppSignedRequestPlainClientAPI;
appSigningSecret: AppSigningSecretPlainClientAPI;
appUpload: AppUploadPlainClientAPI;
asset: {
archive(params: OptionalDefaults<GetSpaceEnvironmentParams & {
assetId: string;
}>): Promise<AssetProps>;
create(params: OptionalDefaults<GetSpaceEnvironmentParams>, rawData: CreateAssetProps): Promise<AssetProps>;
createFromFiles(params: OptionalDefaults<GetSpaceEnvironmentParams>, data: Omit<AssetFileProp, "sys">): Promise<AssetProps>;
createWithId(params: OptionalDefaults<GetSpaceEnvironmentParams & {
assetId: string;
}>, rawData: CreateAssetProps): Promise<AssetProps>;
delete(params: OptionalDefaults<GetSpaceEnvironmentParams & {
assetId: string;
}>): Promise<any>;
get(params: OptionalDefaults<GetSpaceEnvironmentParams & {
assetId: string;
} & QueryParams>, rawData?: unknown, headers?: Partial<RawAxiosHeaders & {
Accept: AxiosHeaderValue;
Authorization: AxiosHeaderValue;
Content-Encoding: AxiosHeaderValue;
Content-Length: AxiosHeaderValue;
User-Agent: AxiosHeaderValue;
} & {
Content-Type: ContentType;
}>): Promise<AssetProps>;
getMany(params: OptionalDefaults<GetSpaceEnvironmentParams & QueryParams>, rawData?: unknown, headers?: Partial<RawAxiosHeaders & {
Accept: AxiosHeaderValue;
Authorization: AxiosHeaderValue;
Content-Encoding: AxiosHeaderValue;
Content-Length: AxiosHeaderValue;
User-Agent: AxiosHeaderValue;
} & {
Content-Type: ContentType;
}>): Promise<CollectionProp<AssetProps>>;
getPublished(params: OptionalDefaults<GetSpaceEnvironmentParams & QueryParams>, rawData?: unknown, headers?: Partial<RawAxiosHeaders & {
Accept: AxiosHeaderValue;
Authorization: AxiosHeaderValue;
Content-Encoding: AxiosHeaderValue;
Content-Length: AxiosHeaderValue;
User-Agent: AxiosHeaderValue;
} & {
Content-Type: ContentType;
}>): Promise<CollectionProp<AssetProps>>;
processForAllLocales(params: OptionalDefaults<GetSpaceEnvironmentParams>, asset: AssetProps, processingOptions?: AssetProcessingForLocale): Promise<AssetProps>;
processForLocale(params: OptionalDefaults<GetSpaceEnvironmentParams>, asset: AssetProps, locale: string, processingOptions?: AssetProcessingForLocale): Promise<AssetProps>;
publish(params: OptionalDefaults<GetSpaceEnvironmentParams & {
assetId: string;
}>, rawData: AssetProps): Promise<AssetProps>;
unarchive(params: OptionalDefaults<GetSpaceEnvironmentParams & {
assetId: string;
}>): Promise<AssetProps>;
unpublish(params: OptionalDefaults<GetSpaceEnvironmentParams & {
assetId: string;
}>): Promise<AssetProps>;
update(params: OptionalDefaults<GetSpaceEnvironmentParams & {
assetId: string;
}>, rawData: AssetProps, headers?: Partial<RawAxiosHeaders & {
Accept: AxiosHeaderValue;
Authorization: AxiosHeaderValue;
Content-Encoding: AxiosHeaderValue;
Content-Length: AxiosHeaderValue;
User-Agent: AxiosHeaderValue;
} & {
Content-Type: ContentType;
}>): Promise<AssetProps>;
};
assetKey: {
create(params: OptionalDefaults<GetSpaceEnvironmentParams>, data: CreateAssetKeyProps): Promise<AssetKeyProps>;
};
bulkAction: {
get<T>(params: GetBulkActionParams): Promise<BulkActionProps<T>>;
publish(params: GetSpaceEnvironmentParams, payload: BulkActionPublishPayload): Promise<BulkActionProps<BulkActionPublishPayload>>;
unpublish(params: GetSpaceEnvironmentParams, payload: BulkActionUnpublishPayload): Promise<BulkActionProps<BulkActionUnpublishPayload>>;
validate(params: GetSpaceEnvironmentParams, payload: BulkActionValidatePayload): Promise<BulkActionProps<BulkActionValidatePayload>>;
};
comment: CommentPlainClientAPI;
concept: ConceptPlainClientAPI;
conceptScheme: ConceptSchemePlainClientAPI;
contentType: {
create(params: OptionalDefaults<GetSpaceEnvironmentParams>, rawData: {
description?: string;
displayField?: string;
fields: ContentFields[];
metadata?: ContentTypeMetadata;
name: string;
}): Promise<ContentTypeProps>;
createWithId(params: OptionalDefaults<GetSpaceEnvironmentParams & {
contentTypeId: string;
}>, rawData: {
description?: string;
displayField?: string;
fields: ContentFields[];
metadata?: ContentTypeMetadata;
name: string;
}): Promise<ContentTypeProps>;
delete(params: OptionalDefaults<GetContentTypeParams>): Promise<any>;
get(params: OptionalDefaults<GetSpaceEnvironmentParams & {
contentTypeId: string;
} & QueryParams>): Promise<ContentTypeProps>;
getMany(params: OptionalDefaults<GetSpaceEnvironmentParams & QueryParams>): Promise<CollectionProp<ContentTypeProps>>;
omitAndDeleteField(params: OptionalDefaults<GetContentTypeParams>, contentType: ContentTypeProps, fieldId: string): Promise<ContentTypeProps>;
publish(params: OptionalDefaults<GetContentTypeParams>, rawData: ContentTypeProps): Promise<ContentTypeProps>;
unpublish(params: OptionalDefaults<GetContentTypeParams>): Promise<ContentTypeProps>;
update(params: OptionalDefaults<GetContentTypeParams>, rawData: ContentTypeProps, headers?: Partial<RawAxiosHeaders & {
Accept: AxiosHeaderValue;
Authorization: AxiosHeaderValue;
Content-Encoding: AxiosHeaderValue;
Content-Length: AxiosHeaderValue;
User-Agent: AxiosHeaderValue;
} & {
Content-Type: ContentType;
}>): Promise<ContentTypeProps>;
};
editorInterface: EditorInterfacePlainClientAPI;
entry: {
archive<T>(params: OptionalDefaults<GetSpaceEnvironmentParams & {
entryId: string;
}>): Promise<EntryProps<T>>;
create<T>(params: OptionalDefaults<GetSpaceEnvironmentParams & {
contentTypeId: string;
}>, rawData: CreateEntryProps<T>): Promise<EntryProps<T>>;
createWithId<T>(params: OptionalDefaults<GetSpaceEnvironmentParams & {
contentTypeId: string;
entryId: string;
}>, rawData: CreateEntryProps<T>): Promise<EntryProps<T>>;
delete(params: OptionalDefaults<GetSpaceEnvironmentParams & {
entryId: string;
}>): Promise<any>;
get<T>(params: OptionalDefaults<GetSpaceEnvironmentParams & {
entryId: string;
}>, rawData?: unknown, headers?: Partial<RawAxiosHeaders & {
Accept: AxiosHeaderValue;
Authorization: AxiosHeaderValue;
Content-Encoding: AxiosHeaderValue;
Content-Length: AxiosHeaderValue;
User-Agent: AxiosHeaderValue;
} & {
Content-Type: ContentType;
}>): Promise<EntryProps<T>>;
getMany<T>(params: OptionalDefaults<GetSpaceEnvironmentParams & QueryParams>, rawData?: unknown, headers?: Partial<RawAxiosHeaders & {
Accept: AxiosHeaderValue;
Authorization: AxiosHeaderValue;
Content-Encoding: AxiosHeaderValue;
Content-Length: AxiosHeaderValue;
User-Agent: AxiosHeaderValue;
} & {
Content-Type: ContentType;
}>): Promise<CollectionProp<EntryProps<T>>>;
getPublished<T>(params: OptionalDefaults<GetSpaceEnvironmentParams & QueryParams>, rawData?: unknown, headers?: Partial<RawAxiosHeaders & {
Accept: AxiosHeaderValue;
Authorization: AxiosHeaderValue;
Content-Encoding: AxiosHeaderValue;
Content-Length: AxiosHeaderValue;
User-Agent: AxiosHeaderValue;
} & {
Content-Type: ContentType;
}>): Promise<CollectionProp<EntryProps<T>>>;
patch<T>(params: OptionalDefaults<GetSpaceEnvironmentParams & {
entryId: string;
}>, rawData: OpPatch[], headers?: Partial<RawAxiosHeaders & {
Accept: AxiosHeaderValue;
Authorization: AxiosHeaderValue;
Content-Encoding: AxiosHeaderValue;
Content-Length: AxiosHeaderValue;
User-Agent: AxiosHeaderValue;
} & {
Content-Type: ContentType;
}>): Promise<EntryProps<T>>;
publish<T>(params: OptionalDefaults<GetSpaceEnvironmentParams & {
entryId: string;
}>, rawData: EntryProps<T>): Promise<EntryProps<T>>;
references(params: OptionalDefaults<GetSpaceEnvironmentParams & {
entryId: string;
include?: number;
}>): Promise<EntryReferenceProps>;
unarchive<T>(params: OptionalDefaults<GetSpaceEnvironmentParams & {
entryId: string;
}>): Promise<EntryProps<T>>;
unpublish<T>(params: OptionalDefaults<GetSpaceEnvironmentParams & {
entryId: string;
}>): Promise<EntryProps<T>>;
update<T>(params: OptionalDefaults<GetSpaceEnvironmentParams & {
entryId: string;
}>, rawData: EntryProps<T>, headers?: Partial<RawAxiosHeaders & {
Accept: AxiosHeaderValue;
Authorization: AxiosHeaderValue;
Content-Encoding: AxiosHeaderValue;
Content-Length: AxiosHeaderValue;
User-Agent: AxiosHeaderValue;
} & {
Content-Type: ContentType;
}>): Promise<EntryProps<T>>;
};
environment: EnvironmentPlainClientAPI;
environmentAlias: EnvironmentAliasPlainClientAPI;
environmentTemplate: {
create(params: GetOrganizationParams, rawData: CreateEnvironmentTemplateProps, headers?: Partial<RawAxiosHeaders & {
Accept: AxiosHeaderValue;
Authorization: AxiosHeaderValue;
Content-Encoding: AxiosHeaderValue;
Content-Length: AxiosHeaderValue;
User-Agent: AxiosHeaderValue;
} & {
Content-Type: ContentType;
}>): Promise<EnvironmentTemplateProps>;
delete(params: GetEnvironmentTemplateParams, headers?: Partial<RawAxiosHeaders & {
Accept: AxiosHeaderValue;
Authorization: AxiosHeaderValue;
Content-Encoding: AxiosHeaderValue;
Content-Length: AxiosHeaderValue;
User-Agent: AxiosHeaderValue;
} & {
Content-Type: ContentType;
}>): Promise<void>;
disconnect(params: EnvironmentTemplateParams, headers?: Partial<RawAxiosHeaders & {
Accept: AxiosHeaderValue;
Authorization: AxiosHeaderValue;
Content-Encoding: AxiosHeaderValue;
Content-Length: AxiosHeaderValue;
User-Agent: AxiosHeaderValue;
} & {
Content-Type: ContentType;
}>): Promise<void>;
get(params: GetOrganizationParams & {
environmentTemplateId: string;
} & {
query?: {
select?: string;
};
version?: number;
}, headers?: Partial<RawAxiosHeaders & {
Accept: AxiosHeaderValue;
Authorization: AxiosHeaderValue;
Content-Encoding: AxiosHeaderValue;
Content-Length: AxiosHeaderValue;
User-Agent: AxiosHeaderValue;
} & {
Content-Type: ContentType;
}>): Promise<EnvironmentTemplateProps>;
getMany(params: GetOrganizationParams & {
query?: BasicCursorPaginationOptions & {
select?: string;
};
}, headers?: Partial<RawAxiosHeaders & {
Accept: AxiosHeaderValue;
Authorization: AxiosHeaderValue;
Content-Encoding: AxiosHeaderValue;
Content-Length: AxiosHeaderValue;
User-Agent: AxiosHeaderValue;
} & {
Content-Type: ContentType;
}>): Promise<CursorPaginatedCollectionProp<EnvironmentTemplateProps>>;
install(params: EnvironmentTemplateParams, rawData: CreateEnvironmentTemplateInstallationProps, headers?: Partial<RawAxiosHeaders & {
Accept: AxiosHeaderValue;
Authorization: AxiosHeaderValue;
Content-Encoding: AxiosHeaderValue;
Content-Length: AxiosHeaderValue;
User-Agent: AxiosHeaderValue;
} & {
Content-Type: ContentType;
}>): Promise<EnvironmentTemplateInstallationProps>;
update(params: GetEnvironmentTemplateParams, rawData: EnvironmentTemplateProps, headers?: Partial<RawAxiosHeaders & {
Accept: AxiosHeaderValue;
Authorization: AxiosHeaderValue;
Content-Encoding: AxiosHeaderValue;
Content-Length: AxiosHeaderValue;
User-Agent: AxiosHeaderValue;
} & {
Content-Type: ContentType;
}>): Promise<EnvironmentTemplateProps>;
validate(params: EnvironmentTemplateParams & {
version?: number;
}, rawData: ValidateEnvironmentTemplateInstallationProps, headers?: Partial<RawAxiosHeaders & {
Accept: AxiosHeaderValue;
Authorization: AxiosHeaderValue;
Content-Encoding: AxiosHeaderValue;
Content-Length: AxiosHeaderValue;
User-Agent: AxiosHeaderValue;
} & {
Content-Type: ContentType;
}>): Promise<EnvironmentTemplateValidationProps>;
versions(params: GetOrganizationParams & {
environmentTemplateId: string;
} & {
query?: BasicCursorPaginationOptions & {
select?: string;
};
}, headers?: Partial<RawAxiosHeaders & {
Accept: AxiosHeaderValue;
Authorization: AxiosHeaderValue;
Content-Encoding: AxiosHeaderValue;
Content-Length: AxiosHeaderValue;
User-Agent: AxiosHeaderValue;
} & {
Content-Type: ContentType;
}>): Promise<CursorPaginatedCollectionProp<EnvironmentTemplateProps>>;
versionUpdate(params: GetOrganizationParams & {
environmentTemplateId: string;
} & {
version: number;
}, rawData: {
versionDescription?: string;
versionName?: string;
}, headers?: Partial<RawAxiosHeaders & {
Accept: AxiosHeaderValue;
Authorization: AxiosHeaderValue;
Content-Encoding: AxiosHeaderValue;
Content-Length: AxiosHeaderValue;
User-Agent: AxiosHeaderValue;
} & {
Content-Type: ContentType;
}>): Promise<EnvironmentTemplateProps>;
};
environmentTemplateInstallation: {
getForEnvironment(params: BasicCursorPaginationOptions & EnvironmentTemplateParams & {
installationId?: string;
}, headers?: Partial<RawAxiosHeaders & {
Accept: AxiosHeaderValue;
Authorization: AxiosHeaderValue;
Content-Encoding: AxiosHeaderValue;
Content-Length: AxiosHeaderValue;
User-Agent: AxiosHeaderValue;
} & {
Content-Type: ContentType;
}>): Promise<CursorPaginatedCollectionProp<EnvironmentTemplateInstallationProps>>;
getMany(params: BasicCursorPaginationOptions & {
environmentId?: string;
environmentTemplateId: string;
organizationId: string;
spaceId?: string;
}, headers?: Partial<RawAxiosHeaders & {
Accept: AxiosHeaderValue;
Authorization: AxiosHeaderValue;
Content-Encoding: AxiosHeaderValue;
Content-Length: AxiosHeaderValue;
User-Agent: AxiosHeaderValue;
} & {
Content-Type: ContentType;
}>): Promise<CursorPaginatedCollectionProp<EnvironmentTemplateInstallationProps>>;
};
extension: ExtensionPlainClientAPI;
function: {
getMany(params: OptionalDefaults<GetOrganizationParams & {
appDefinitionId: string;
} & QueryParams>): Promise<CollectionProp<FunctionProps>>;
};
locale: LocalePlainClientAPI;
organization: OrganizationPlainClientAPI;
organizationInvitation: {
create(params: OptionalDefaults<{
organizationId: string;
}>, data: CreateOrganizationInvitationProps, headers?: Partial<RawAxiosHeaders & {
Accept: AxiosHeaderValue;
Authorization: AxiosHeaderValue;
Content-Encoding: AxiosHeaderValue;
Content-Length: AxiosHeaderValue;
User-Agent: AxiosHeaderValue;
} & {
Content-Type: ContentType;
}>): Promise<OrganizationInvitationProps>;
get(params: OptionalDefaults<{
invitationId: string;
organizationId: string;
}>, headers?: Partial<RawAxiosHeaders & {
Accept: AxiosHeaderValue;
Authorization: AxiosHeaderValue;
Content-Encoding: AxiosHeaderValue;
Content-Length: AxiosHeaderValue;
User-Agent: AxiosHeaderValue;
} & {
Content-Type: ContentType;
}>): Promise<OrganizationInvitationProps>;
};
organizationMembership: {
delete(params: OptionalDefaults<GetOrganizationMembershipParams>): Promise<any>;
get(params: OptionalDefaults<GetOrganizationMembershipParams>): Promise<OrganizationMembershipProps>;
getMany(params: OptionalDefaults<GetOrganizationParams & QueryParams>): Promise<CollectionProp<OrganizationMembershipProps>>;
update(params: OptionalDefaults<GetOrganizationMembershipParams>, rawData: OrganizationMembershipProps, headers?: Partial<RawAxiosHeaders & {
Accept: AxiosHeaderValue;
Authorization: AxiosHeaderValue;
Content-Encoding: AxiosHeaderValue;
Content-Length: AxiosHeaderValue;
User-Agent: AxiosHeaderValue;
} & {
Content-Type: ContentType;
}>): Promise<OrganizationMembershipProps>;
};
personalAccessToken: {
create(rawData: CreatePersonalAccessTokenProps, headers?: Partial<RawAxiosHeaders & {
Accept: AxiosHeaderValue;
Authorization: AxiosHeaderValue;
Content-Encoding: AxiosHeaderValue;
Content-Length: AxiosHeaderValue;
User-Agent: AxiosHeaderValue;
} & {
Content-Type: ContentType;
}>): Promise<PersonalAccessTokenProps>;
get(params: OptionalDefaults<{
tokenId: string;
}>): Promise<PersonalAccessTokenProps>;
getMany(params: OptionalDefaults<QueryParams>): Promise<CollectionProp<PersonalAccessTokenProps>>;
revoke(params: OptionalDefaults<{
tokenId: string;
}>): Promise<PersonalAccessTokenProps>;
};
previewApiKey: {
get(params: OptionalDefaults<GetSpaceParams & {
previewApiKeyId: string;
}>): Promise<PreviewApiKeyProps>;
getMany(params: OptionalDefaults<GetSpaceParams & QueryParams>): Promise<CollectionProp<PreviewApiKeyProps>>;
};
raw: {
delete<T>(url: string, config?: RawAxiosRequestConfig): Promise<T>;
get<T>(url: string, config?: RawAxiosRequestConfig): Promise<T>;
getDefaultParams(): undefined | DefaultParams;
http<T>(url: string, config?: RawAxiosRequestConfig): Promise<T>;
patch<T>(url: string, payload?: any, config?: RawAxiosRequestConfig): Promise<T>;
post<T>(url: string, payload?: any, config?: RawAxiosRequestConfig): Promise<T>;
put<T>(url: string, payload?: any, config?: RawAxiosRequestConfig): Promise<T>;
};
release: {
archive(params: OptionalDefaults<GetSpaceEnvironmentParams & {
releaseId: string;
} & {
version: number;
}>): Promise<ReleaseProps>;
create(params: OptionalDefaults<GetSpaceEnvironmentParams>, data: ReleasePayload): Promise<ReleaseProps>;
delete(params: OptionalDefaults<GetReleaseParams>): Promise<void>;
get(params: OptionalDefaults<GetReleaseParams>): Promise<ReleaseProps>;
publish(params: OptionalDefaults<GetSpaceEnvironmentParams & {
releaseId: string;
} & {
version: number;
}>): Promise<ReleaseActionProps<"publish">>;
query(params: Omit<GetSpaceEnvironmentParams, keyof DefaultParams> & Partial<Pick<GetSpaceEnvironmentParams, keyof GetSpaceEnvironmentParams>> & {
query?: ReleaseQueryOptions;
}): Promise<CursorPaginatedCollectionProp<ReleaseProps>>;
unarchive(params: OptionalDefaults<GetSpaceEnvironmentParams & {
releaseId: string;
} & {
version: number;
}>): Promise<ReleaseProps>;
unpublish(params: OptionalDefaults<GetSpaceEnvironmentParams & {
releaseId: string;
} & {
version: number;
}>): Promise<ReleaseActionProps<"unpublish">>;
update(params: OptionalDefaults<GetSpaceEnvironmentParams & {
releaseId: string;
} & {
version: number;
}>, data: ReleasePayload): Promise<ReleaseProps>;
validate(params: OptionalDefaults<GetReleaseParams>, data?: ReleaseValidatePayload): Promise<ReleaseActionProps<"validate">>;
};
releaseAction: {
get(params: Omit<GetReleaseParams, keyof DefaultParams> & Partial<Pick<GetReleaseParams, keyof GetSpaceEnvironmentParams>> & {
actionId: string;
}): Promise<ReleaseActionProps<any>>;
getMany(params: Omit<GetSpaceEnvironmentParams, keyof DefaultParams> & Partial<Pick<GetSpaceEnvironmentParams, keyof GetSpaceEnvironmentParams>> & {
query?: ReleaseActionQueryOptions;
}): Promise<CollectionProp<ReleaseActionProps<any>>>;
queryForRelease(params: Omit<GetReleaseParams, keyof DefaultParams> & Partial<Pick<GetReleaseParams, keyof GetSpaceEnvironmentParams>> & {
query?: ReleaseActionQueryOptions;
}): Promise<CollectionProp<ReleaseActionProps<any>>>;
};
resource: ResourcePlainAPI;
resourceProvider: ResourceProviderPlainClientAPI;
resourceType: ResourceTypePlainClientAPI;
role: RolePlainClientAPI;
scheduledActions: {
create(params: OptionalDefaults<GetSpaceParams>, data: CreateUpdateScheduledActionProps): Promise<ScheduledActionProps>;
delete(params: OptionalDefaults<GetSpaceEnvironmentParams & {
scheduledActionId: string;
}>): Promise<ScheduledActionProps>;
get(params: Omit<GetSpaceParams, keyof DefaultParams> & Partial<Pick<GetSpaceParams, "spaceId">> & {
environmentId: string;
scheduledActionId: string;
}): Promise<ScheduledActionProps>;
getMany(params: OptionalDefaults<GetSpaceParams & QueryParams>): Promise<CursorPaginatedCollectionProp<ScheduledActionProps>>;
update(params: OptionalDefaults<GetSpaceParams & {
scheduledActionId: string;
version: number;
}>, data: CreateUpdateScheduledActionProps): Promise<ScheduledActionProps>;
};
snapshot: {
getForContentType(params: OptionalDefaults<GetSpaceEnvironmentParams & {
contentTypeId: string;
} & {
snapshotId: string;
}>): Promise<SnapshotProps<ContentTypeProps>>;
getForEntry<T>(params: OptionalDefaults<GetSpaceEnvironmentParams & {
entryId: string;
} & {
snapshotId: string;
}>): Promise<SnapshotProps<Omit<EntryProps<T>, "metadata">>>;
getManyForContentType(params: OptionalDefaults<GetSpaceEnvironmentParams & {
contentTypeId: string;
} & QueryParams>): Promise<CollectionProp<SnapshotProps<ContentTypeProps>>>;
getManyForEntry<T>(params: OptionalDefaults<GetSpaceEnvironmentParams & {
entryId: string;
} & QueryParams>): Promise<CollectionProp<SnapshotProps<Omit<EntryProps<T>, "metadata">>>>;
};
space: SpacePlainClientAPI;
spaceMember: SpaceMemberPlainClientAPI;
spaceMembership: SpaceMembershipPlainClientAPI;
tag: TagPlainClientAPI;
task: TaskPlainClientAPI;
team: TeamPlainClientAPI;
teamMembership: TeamMembershipPlainClientAPI;
teamSpaceMembership: TeamSpaceMembershipPlainClientAPI;
uiConfig: UIConfigPlainClientAPI;
upload: UploadPlainClientAPI;
uploadCredential: UploadCredentialAPI;
usage: UsagePlainClientAPI;
user: UserPlainClientAPI;
userUIConfig: UserUIConfigPlainClientAPI;
webhook: WebhookPlainClientAPI;
workflow: WorkflowPlainClientAPI;
workflowDefinition: WorkflowDefinitionPlainClientAPI;
workflowsChangelog: WorkflowsChangelogPlainClientAPI;
}Type Alias PlainClientDefaultParams
Type Alias PreviewApiKeyProps
Type Alias QueryParams
Type Alias ReleaseActionSysProps
createdAt: ISO8601Timestamp;
createdBy: Link<"User">;
environment: Link<"Environment">;
id: string;
release: Link<"Release">;
space: Link<"Space">;
status: ReleaseActionStatuses;
type: "ReleaseAction";
updatedAt: ISO8601Timestamp;
updatedBy: Link<"User">;
}Type Alias ReleaseActionTypes
Type Alias ReleaseMetadata
withReferences: {
entity: Link<"Entry">;
filter: Record<ReleaseReferenceFilters, string[]>;
}[];
}Type Alias ReleaseReferenceFilters
Type Alias ReleaseSysProps
archivedAt?: ISO8601Timestamp;
archivedBy?: Link<"User">;
createdAt: ISO8601Timestamp;
createdBy: Link<"User"> | Link<"AppDefinition">;
environment: Link<"Environment">;
id: string;
lastAction?: Link<"ReleaseAction">;
space: Link<"Space">;
status: ReleaseStatus;
type: "Release";
updatedAt: ISO8601Timestamp;
updatedBy: Link<"User"> | Link<"AppDefinition">;
version: number;
}Type Alias ResourceProps
fields: {
badge?: {
label: string;
variant:
| "primary"
| "negative"
| "positive"
| "warning"
| "secondary";
};
description?: string;
externalUrl?: string;
image?: {
altText?: string;
url: string;
};
subtitle?: string;
title: string;
};
sys: {
appDefinition: SysLink;
resourceProvider: SysLink;
resourceType: SysLink;
type: "Resource";
urn: string;
};
}Type Alias ResourceProviderProps
function: SysLink;
sys: Omit<BasicMetaSysProps, "version"> & {
appDefinition: SysLink;
organization: SysLink;
};
type: "function";
}Type declaration
function: SysLink
sys: Omit<BasicMetaSysProps, "version"> & {
appDefinition: SysLink;
organization: SysLink;
}type: "function"
Type Alias ResourceQueryOptions
Type Alias ResourceTypeProps
defaultFieldMapping: {
badge?: {
label: string;
variant: string;
};
description?: string;
externalUrl?: string;
image?: {
altText?: string;
url: string;
};
subtitle?: string;
title: string;
};
name: string;
sys: Omit<BasicMetaSysProps, "version"> & {
appDefinition: SysLink;
organization: SysLink;
resourceProvider: SysLink;
};
}Type declaration
default
badge?: {
label: string;
variant: string;
};
description?: string;
externalUrl?: string;
image?: {
altText?: string;
url: string;
};
subtitle?: string;
title: string;
}Optional
badge?: {
label: string;
variant: string;
}label: string
variant: string
Optional
description?: stringOptional
externalOptional
image?: {
altText?: string;
url: string;
}Optional
alturl: string
Optional
subtitle?: stringtitle: string
name: string
sys: Omit<BasicMetaSysProps, "version"> & {
appDefinition: SysLink;
organization: SysLink;
resourceProvider: SysLink;
}Type Alias RichTextCommentProps
Type Alias RoleProps
description?: string;
name: string;
permissions: {
ContentDelivery: string[] | string;
ContentModel: string[];
EnvironmentAliases: string[] | string;
Environments: string[] | string;
Settings: string[] | string;
Tags: string[] | string;
};
policies: {
actions: ActionType[] | "all";
constraint: ConstraintType;
effect: string;
}[];
sys: BasicMetaSysProps & {
space: SysLink;
};
}Type declaration
Optional
description?: stringname: string
permissions: {
ContentDelivery: string[] | string;
ContentModel: string[];
EnvironmentAliases: string[] | string;
Environments: string[] | string;
Settings: string[] | string;
Tags: string[] | string;
}Content
Content
Environment
Environments: string[] | string
Settings: string[] | string
Tags: string[] | string
policies: {
actions: ActionType[] | "all";
constraint: ConstraintType;
effect: string;
}[]sys: BasicMetaSysProps & {
space: SysLink;
}Type Alias ScheduledActionProps
action: SchedulableActionType;
entity: Link<SchedulableEntityType>;
environment?: {
sys: MetaLinkProps;
};
error?: ScheduledActionFailedError;
payload?: ScheduledActionPayloadProps;
scheduledFor: {
datetime: ISO8601Timestamp;
timezone?: string;
};
sys: ScheduledActionSysProps;
}Type declaration
action: SchedulableActionType
entity: Link<SchedulableEntityType>
Optional
environment?: {
sys: MetaLinkProps;
}sys: MetaLinkProps
Optional
error?: ScheduledActionFailedErrorOptional
payload?: ScheduledActionPayloadPropsscheduled
datetime: ISO8601Timestamp;
timezone?: string;
}datetime: ISO8601Timestamp
Optional
timezone?: stringsys: ScheduledActionSysProps
Type Alias ScheduledActionSysProps
canceledAt?: ISO8601Timestamp;
canceledBy?: Link<"User"> | Link<"AppDefinition">;
createdAt: ISO8601Timestamp;
createdBy: Link<"User"> | Link<"AppDefinition">;
id: string;
space: SysLink;
status: ScheduledActionStatus;
type: "ScheduledAction";
updatedAt: ISO8601Timestamp;
updatedBy: Link<"User"> | Link<"AppDefinition">;
version: number;
}Type declaration
Optional
canceledOptional
canceledcreated
created
id: string
space: SysLink
status: ScheduledActionStatus
type: "ScheduledAction"
updated
updated
version: number
Type Alias SnapshotProps<T>
snapshot: T;
sys: MetaSysProps & {
snapshotEntityType: string;
snapshotType: string;
};
}Type Parameters
Type Alias Space
Type Alias SpaceEnvResourceTypeProps
sys: Partial<Pick<ResourceTypeProps["sys"], OptionalSysFields>> & Omit<ResourceTypeProps["sys"], OptionalSysFields>;
}Type Alias SpaceMemberProps
Type declaration
admin: boolean
roles: {
sys: MetaLinkProps;
}[]sys: MetaSysProps
Type Alias SpaceMembershipProps
admin: boolean;
roles: SysLink[];
sys: MetaSysProps & {
space: SysLink;
user: SysLink;
};
user: SysLink;
}Type Alias SpaceProps
name: string;
sys: BasicMetaSysProps & {
archivedAt?: string;
organization: {
sys: {
id: string;
};
};
};
}Type Alias SpaceQueryParams
Type Alias TagProps
name: string;
sys: TagSysProps;
}Type Alias TagVisibility
Type Alias TaskProps
assignedTo: Link<"User" | "Team">;
body: string;
dueDate?: string;
status: TaskStatus;
sys: TaskSysProps;
}Type Alias TeamMembershipProps
admin: boolean;
organizationMembershipId: string;
sys: MetaSysProps & {
organization: {
sys: MetaLinkProps;
};
organizationMembership: {
sys: MetaLinkProps;
};
team: {
sys: MetaLinkProps;
};
};
}Type declaration
admin: boolean
organization
sys: MetaSysProps & {
organization: {
sys: MetaLinkProps;
};
organizationMembership: {
sys: MetaLinkProps;
};
team: {
sys: MetaLinkProps;
};
}Type Alias TeamProps
description: string;
name: string;
sys: MetaSysProps & {
memberCount: number;
organization: {
sys: MetaLinkProps;
};
};
}Type declaration
description: string
name: string
sys: MetaSysProps & {
memberCount: number;
organization: {
sys: MetaLinkProps;
};
}Type Alias TeamSpaceMembershipProps
admin: boolean;
roles: {
sys: MetaLinkProps;
}[];
sys: MetaSysProps & {
space: {
sys: MetaLinkProps;
};
team: {
sys: MetaLinkProps;
};
};
}Type declaration
admin: boolean
roles: {
sys: MetaLinkProps;
}[]sys: MetaSysProps & {
space: {
sys: MetaLinkProps;
};
team: {
sys: MetaLinkProps;
};
}Type Alias UIConfigProps
assetListViews: ViewFolder[];
entryListViews: ViewFolder[];
homeViews: HomeView[];
sys: UIConfigSysProps;
}Type declaration
asset
entry
home
sys: UIConfigSysProps
Type Alias UIExtensionProps
extension: {
fieldTypes: FieldType[];
name: string;
parameters?: {
installation?: ParameterDefinition<InstallationParameterType>[];
instance?: ParameterDefinition[];
};
sidebar?: boolean;
src?: string;
srcdoc?: string;
};
parameters?: DefinedParameters;
sys: ExtensionSysProps;
}Type declaration
extension: {
fieldTypes: FieldType[];
name: string;
parameters?: {
installation?: ParameterDefinition<InstallationParameterType>[];
instance?: ParameterDefinition[];
};
sidebar?: boolean;
src?: string;
srcdoc?: string;
}field
name: string
Optional
parameters?: {
installation?: ParameterDefinition<InstallationParameterType>[];
instance?: ParameterDefinition[];
}Optional
installation?: ParameterDefinition<InstallationParameterType>[]Optional
instance?: ParameterDefinition[]Optional
sidebar?: booleanOptional
src?: stringOptional
srcdoc?: stringOptional
parameters?: DefinedParameterssys: ExtensionSysProps
Type Alias UpdateCommentProps
Type Alias UpdateConceptParams
Type Alias UpdateConceptSchemeParams
Type Alias UpdateTaskProps
Type Alias UpdateWebhookProps
| "headers"
| "name"
| "topics"
| "url"
| "active">Type Alias UpdateWorkflowDefinitionParams
Type Alias UpdateWorkflowDefinitionProps
steps: (CreateWorkflowStepProps | UpdateWorkflowStepProps)[];
sys: Pick<WorkflowDefinitionSysProps, "version">;
}Type Alias UpdateWorkflowProps
Type Alias UpdateWorkflowStepProps
Type Alias UploadCredentialProps
Type declaration
sys: MetaSysProps & {
environment?: SysLink;
space: SysLink;
}Type Alias UploadProps
Type declaration
sys: MetaSysProps & {
environment?: SysLink;
space: SysLink;
}Type Alias UpsertResourceProviderProps
Type Alias UpsertResourceTypeProps
Type Alias UpsertWebhookSigningSecretPayload
value: string;
}Type Alias UsageProps
dateRange: {
endAt: string;
startAt: string;
};
metric: UsageMetricEnum;
sys: MetaSysProps & {
organization?: {
sys: MetaLinkProps;
};
};
unitOfMeasure: string;
usage: number;
usagePerDay: {
[key: string]: number;
};
}Type declaration
date
endAt: string;
startAt: string;
}end
start
metric: UsageMetricEnum
sys: MetaSysProps & {
organization?: {
sys: MetaLinkProps;
};
}unit
usage: number
usage
[key: string]: number;
}[key: string]: number
Type Alias UserProps
2faEnabled: boolean;
activated: boolean;
avatarUrl: string;
confirmed: boolean;
cookieConsentData: string;
email: string;
firstName: string;
lastName: string;
signInCount: number;
sys: BasicMetaSysProps;
}Type declaration
2fa
activated: boolean
avatar
confirmed: boolean
cookie
email: string
first
last
sign
sys: BasicMetaSysProps
Type Alias UserUIConfigProps
assetListViews: ViewFolder[];
entryListViews: ViewFolder[];
sys: UserUIConfigSysProps;
}Type declaration
asset
entry
sys: UserUIConfigSysProps
Type Alias ValidateEnvironmentTemplateInstallationProps
Type Alias ValidationFinding
details: Record<string, unknown>;
message: string;
}Type Alias WebhookCallRequest
body: string;
headers: {
[key: string]: string;
};
method: string;
url: string;
}Type Alias WebhookFilter
| EqualityConstraint
| InConstraint
| RegexpConstraint
| NotConstraintType Alias WebhookProps
active: boolean;
filters?: WebhookFilter[];
headers: WebhookHeader[];
httpBasicPassword?: string;
httpBasicUsername?: string;
name: string;
sys: BasicMetaSysProps & {
space: SysLink;
};
topics: string[];
transformation?: WebhookTransformation;
url: string;
}Type declaration
active: boolean
Optional
filters?: WebhookFilter[]headers: WebhookHeader[]
Optional
httpOptional
httpname: string
sys: BasicMetaSysProps & {
space: SysLink;
}topics: string[]
Optional
transformation?: WebhookTransformationurl: string
Type Alias WebhookSigningSecretProps
redactedValue: string;
sys: WebhookSigningSecretSys & {
space: {
sys: MetaLinkProps;
};
};
}Type Alias WebhookTransformation
body?: JsonValue;
contentType?:
| null
| "application/vnd.contentful.management.v1+json"
| "application/vnd.contentful.management.v1+json; charset=utf-8"
| "application/json"
| "application/json; charset=utf-8"
| "application/x-www-form-urlencoded"
| "application/x-www-form-urlencoded; charset=utf-8";
includeContentLength?: boolean | null;
method?:
| null
| "POST"
| "GET"
| "PUT"
| "PATCH"
| "DELETE";
}Type Alias WorkflowDefinitionProps
appliesTo?: WorkflowDefinitionValidationLink[];
description?: string;
flowType?: "no_restriction" | "strict_neighbor";
name: string;
startOnEntityCreation?: boolean;
steps: WorkflowStepProps[];
sys: WorkflowDefinitionSysProps;
}Type Alias WorkflowDefinitionQueryOptions
Type Alias WorkflowDefinitionSysProps
| "id"
| "version"
| "createdAt"
| "createdBy"
| "updatedAt"
| "updatedBy"> & {
environment: SysLink;
isLocked: boolean;
space: SysLink;
type: "WorkflowDefinition";
}Type Alias WorkflowDefinitionValidationLink
linkType: "Entry";
type: "Link";
validations: {
linkContentType: string[];
}[];
}Type Alias WorkflowProps
stepId?: string;
sys: WorkflowSysProps;
}Type Alias WorkflowQueryOptions
order?: OrderQueryParam;
stepId[in]?: string;
sys.entity.sys.id[in]?: string;
sys.entity.sys.linkType?: string;
sys.workflowDefinition.sys.id?: string;
}Type declaration
Optional
order?: OrderQueryParamOptional
stepOptional
sys.entity.sys.id[in]?: stringsys.entity.sys.linkType
Optional
sys.entity.sys.linkOptional
sys.workflowType Alias WorkflowStepAction
Type Alias WorkflowStepAppAction
appActionId: string;
appId: string;
configuration?: {
body?: Record<string, any>;
headers?: Record<string, string>;
};
type: "app";
}Type Alias WorkflowStepEmailAction
configuration: {
recipients: WorkflowStepEmailActionRecipient[];
};
type: "email";
}Type Alias WorkflowStepProps
actions?: WorkflowStepAction[];
annotations?: string[];
description?: string;
id: string;
name: string;
permissions?: WorkflowStepPermission[];
}Type Alias WorkflowsChangelogEntryProps
entity: Link<"Entry">;
event: string;
eventAt: string;
eventBy: SysLink;
stepAnnotations: string[];
stepId: string;
stepName: string;
workflow: VersionedLink<"Workflow">;
workflowDefinition: Link<"WorkflowDefinition">;
}Type Alias WorkflowsChangelogQueryOptions
entity.sys.id: string;
entity.sys.linkType: string;
eventAt[gte]?: string;
eventAt[lte]?: string;
workflow.sys.id?: string;
workflowDefinition.sys.id[in]?: string;
}Type declaration
entity.sys.id: string
sys.entity.sys.linkType
entity.sys.link
Optional
eventOptional
eventOptional
workflow.sys.id?: stringOptional
workflowVariable ReleaseReferenceFilters
Class RestAdapter
Implements
Index
Constructors
Class RestAdapter
Implements
Index
Constructors
Methods
Constructors
constructor
Parameters
Returns RestAdapter
Methods
make
Type Parameters
Parameters
Returns Promise<R>
Constructors
constructor
Parameters
Returns RestAdapter
Methods
make
Type Parameters
Parameters
Returns Promise<R>
Enumeration BulkActionStatus
Index
Enumeration Members
Enumeration BulkActionStatus
Index
Enumeration Members
failed
in
succeeded
Enumeration ScheduledActionReferenceFilters
Index
Enumeration Members
Enumeration ScheduledActionReferenceFilters
Index
Enumeration Members
Enumeration WorkflowStepPermissionAction
Enumeration WorkflowStepPermissionType
Index
Enumeration Members
Enumeration WorkflowStepPermissionType
Index
Enumeration Members
Function createClient
Function createClient
Parameters
-const client = contentfulManagement.createClient({
accessToken: 'myAccessToken'
})
Returns ClientAPI
Parameters
defaults?: DefaultParams;
type: "plain";
}Optional
defaults?: DefaultParamstype: "plain"
Returns PlainClientAPI
Parameters
alphaFeatures: string[];
defaults?: DefaultParams;
type?: "plain";
}alpha
Optional
defaults?: DefaultParamsOptional
type?: "plain"Returns ClientAPI | PlainClientAPI
Returns ClientAPI
Parameters
defaults?: DefaultParams;
type: "plain";
}Optional
defaults?: DefaultParamstype: "plain"
Returns PlainClientAPI
Parameters
alphaFeatures: string[];
defaults?: DefaultParams;
type?: "plain";
}alpha
Optional
defaults?: DefaultParamsOptional
type?: "plain"Returns ClientAPI | PlainClientAPI
Function fetchAll
fetchAll
will only
+Function fetchAll
fetchAll
will only
work with the more common version of supplying the limit, skip, and pageNext parameters via a distinct query
property in the
parameters.Type Parameters
Returns Promise<Entity[]>
Type Parameters
Returns Promise<Entity[]>
Function isDraft
Parameters
sys: MetaSysProps;
}sys: MetaSysProps
Returns boolean
Function isDraft
Parameters
sys: MetaSysProps;
}sys: MetaSysProps
Returns boolean
Function isPublished
Parameters
sys: MetaSysProps;
}sys: MetaSysProps
Returns boolean
Function isPublished
Parameters
sys: MetaSysProps;
}sys: MetaSysProps
Returns boolean
Function isUpdated
Parameters
sys: MetaSysProps;
}sys: MetaSysProps
Returns boolean
Function isUpdated
Parameters
sys: MetaSysProps;
}sys: MetaSysProps
Returns boolean
contentful-management.js - v11.40.2
Class Hierarchy
contentful-management.js - v11.40.3
Class Hierarchy
contentful-management.js - v11.40.2
contentful-management.js - v11.40.3
JavaScript
License
Code of Conduct
Interface AccessToken
name: string;
revokedAt: null | string;
scopes: "content_management_manage"[];
sys: AccessTokenSysProps;
token?: string;
revoke(): Promise<AccessToken>;
toPlainObject(): AccessTokenProp;
}Hierarchy (view full)
Index
Properties
Interface AccessToken
name: string;
revokedAt: null | string;
scopes: "content_management_manage"[];
sys: AccessTokenSysProps;
token?: string;
revoke(): Promise<AccessToken>;
toPlainObject(): AccessTokenProp;
}Hierarchy (view full)
Properties
name
revoked
scopes
sys
Optional
token Methods
revoke
Properties
name
revoked
scopes
sys
Optional
token Methods
revoke
Returns Promise<AccessToken>
to
Returns AccessTokenProp
to
Returns AccessTokenProp
Interface Adapter
Implemented by
Index
Properties
Interface Adapter
Implemented by
Index
Properties
Interface ApiKey
accessToken: string;
description?: string;
environments: {
sys: MetaLinkProps;
}[];
name: string;
policies?: {
action: string;
effect: string;
}[];
preview_api_key: {
sys: MetaLinkProps;
};
sys: MetaSysProps;
delete(): Promise<void>;
toPlainObject(): ApiKeyProps;
update(): Promise<ApiKey>;
}Hierarchy (view full)
Index
Properties
Interface ApiKey
accessToken: string;
description?: string;
environments: {
sys: MetaLinkProps;
}[];
name: string;
policies?: {
action: string;
effect: string;
}[];
preview_api_key: {
sys: MetaLinkProps;
};
sys: MetaSysProps;
delete(): Promise<void>;
toPlainObject(): ApiKeyProps;
update(): Promise<ApiKey>;
}Hierarchy (view full)
Index
Properties
Methods
Properties
access
Optional
descriptionenvironments
name
Optional
policies
action: string;
effect: string;
}[]preview_
sys
Methods
delete
to
Returns ApiKeyProps
update
to
Returns ApiKeyProps
update
Interface AppAccessToken
sys: AppAccessTokenSys;
token: string;
toPlainObject(): AppAccessTokenProps;
}Hierarchy (view full)
Index
Properties
Interface AppAccessToken
sys: AppAccessTokenSys;
token: string;
toPlainObject(): AppAccessTokenProps;
}Hierarchy (view full)
Index
Properties
Methods
Properties
sys
token
Methods
to
Returns AppAccessTokenProps
token
Methods
to
Returns AppAccessTokenProps
Interface AppActionCall
Hierarchy (view full)
Index
Properties
Interface AppActionCall
Hierarchy (view full)
Index
Properties
Methods
Methods
to
Returns AppActionCallProps
Methods
to
Returns AppActionCallProps
Interface AppBundle
comment?: string;
files: AppBundleFile[];
sys: AppBundleSys;
delete(): Promise<void>;
toPlainObject(): AppBundleProps;
}Hierarchy (view full)
Index
Properties
Interface AppBundle
comment?: string;
files: AppBundleFile[];
sys: AppBundleSys;
delete(): Promise<void>;
toPlainObject(): AppBundleProps;
}Hierarchy (view full)
Index
Properties
Methods
Properties
Optional
commentfiles
sys
Methods
delete
files
sys
Methods
delete
to
Returns AppBundleProps
to
Returns AppBundleProps
Interface AppDetails
icon?: AppIcon;
sys: AppDetailsSys;
delete(): Promise<void>;
toPlainObject(): AppDetailsProps;
}Hierarchy (view full)
Index
Properties
Interface AppDetails
icon?: AppIcon;
sys: AppDetailsSys;
delete(): Promise<void>;
toPlainObject(): AppDetailsProps;
}Hierarchy (view full)
Index
Properties
Methods
Methods
delete
to
Returns AppDetailsProps
to
Returns AppDetailsProps
Interface AppEventSubscription
sys: AppEventSubscriptionSys;
targetUrl: string;
topics: string[];
delete(): Promise<void>;
toPlainObject(): AppEventSubscriptionProps;
}Hierarchy (view full)
Index
Properties
Interface AppEventSubscription
sys: AppEventSubscriptionSys;
targetUrl: string;
topics: string[];
delete(): Promise<void>;
toPlainObject(): AppEventSubscriptionProps;
}Hierarchy (view full)
Index
Properties
Methods
Properties
sys
target
topics
Methods
delete
target
topics
Methods
delete
to
Returns AppEventSubscriptionProps
to
Returns AppEventSubscriptionProps
Interface AppIcon
Interface AppInstallation
parameters?: FreeFormParameters;
sys: Omit<BasicMetaSysProps, "id"> & {
appDefinition: SysLink;
environment: SysLink;
space: SysLink;
};
delete(): Promise<void>;
toPlainObject(): AppInstallationProps;
update(): Promise<AppInstallation>;
}Hierarchy (view full)
Index
Properties
Interface AppInstallation
parameters?: FreeFormParameters;
sys: Omit<BasicMetaSysProps, "id"> & {
appDefinition: SysLink;
environment: SysLink;
space: SysLink;
};
delete(): Promise<void>;
toPlainObject(): AppInstallationProps;
update(): Promise<AppInstallation>;
}Hierarchy (view full)
Index
Properties
Methods
Properties
Optional
parameterssys
appDefinition: SysLink;
environment: SysLink;
space: SysLink;
} Methods
delete
sys
appDefinition: SysLink;
environment: SysLink;
space: SysLink;
} Methods
delete
to
Returns AppInstallationProps
update
to
Returns AppInstallationProps
update
Returns Promise<AppInstallation>
Interface AppKey
generated?: {
privateKey: string;
};
jwk: JWK;
sys: AppKeySys;
delete(): Promise<void>;
toPlainObject(): AppKeyProps;
}Hierarchy (view full)
Index
Properties
Interface AppKey
generated?: {
privateKey: string;
};
jwk: JWK;
sys: AppKeySys;
delete(): Promise<void>;
toPlainObject(): AppKeyProps;
}Hierarchy (view full)
Index
Properties
Methods
jwk
sys
Methods
delete
to
Returns AppKeyProps
to
Returns AppKeyProps
Interface AppSignedRequest
additionalHeaders: {
x-contentful-environment-id: string;
x-contentful-signature: string;
x-contentful-signed-headers: string;
x-contentful-space-id: string;
x-contentful-timestamp: string;
x-contentful-user-id: string;
};
sys: AppSignedRequestSys;
toPlainObject(): AppSignedRequestProps;
}Hierarchy (view full)
Index
Properties
Interface AppSignedRequest
additionalHeaders: {
x-contentful-environment-id: string;
x-contentful-signature: string;
x-contentful-signed-headers: string;
x-contentful-space-id: string;
x-contentful-timestamp: string;
x-contentful-user-id: string;
};
sys: AppSignedRequestSys;
toPlainObject(): AppSignedRequestProps;
}Hierarchy (view full)
Index
Properties
Methods
Properties
additional
x-contentful-environment-id: string;
x-contentful-signature: string;
x-contentful-signed-headers: string;
x-contentful-space-id: string;
x-contentful-timestamp: string;
x-contentful-user-id: string;
}sys
Methods
to
Returns AppSignedRequestProps
sys
Methods
to
Returns AppSignedRequestProps
Interface AppSigningSecret
redactedValue: string;
sys: AppSigningSecretSys;
delete(): Promise<void>;
toPlainObject(): AppSigningSecretProps;
}Hierarchy (view full)
Index
Properties
Interface AppSigningSecret
redactedValue: string;
sys: AppSigningSecretSys;
delete(): Promise<void>;
toPlainObject(): AppSigningSecretProps;
}Hierarchy (view full)
Index
Properties
Methods
Properties
redacted
sys
Methods
delete
to
Returns AppSigningSecretProps
to
Returns AppSigningSecretProps
Interface AppUpload
sys: {
createdAt: string;
createdBy?: SysLink;
id: string;
type: string;
updatedAt: string;
updatedBy?: SysLink;
} & {
expiresAt: string;
organization: SysLink;
};
delete(): Promise<void>;
toPlainObject(): AppUploadProps;
}Hierarchy (view full)
Index
Properties
Interface AppUpload
sys: {
createdAt: string;
createdBy?: SysLink;
id: string;
type: string;
updatedAt: string;
updatedBy?: SysLink;
} & {
expiresAt: string;
organization: SysLink;
};
delete(): Promise<void>;
toPlainObject(): AppUploadProps;
}Hierarchy (view full)
Index
Properties
Methods
Methods
delete
to
Returns AppUploadProps
to
Returns AppUploadProps
Interface Asset
fields: {
description?: {
[key: string]: string;
};
file: {
[key: string]: {
contentType: string;
details?: Record<string, any>;
fileName: string;
upload?: string;
uploadFrom?: Record<string, any>;
url?: string;
};
};
title: {
[key: string]: string;
};
};
metadata?: MetadataProps;
sys: EntityMetaSysProps;
archive(): Promise<Asset>;
delete(): Promise<void>;
isArchived(): boolean;
isDraft(): boolean;
isPublished(): boolean;
isUpdated(): boolean;
processForAllLocales(options?: AssetProcessingForLocale): Promise<Asset>;
processForLocale(locale: string, Options?: AssetProcessingForLocale): Promise<Asset>;
publish(): Promise<Asset>;
toPlainObject(): AssetProps;
unarchive(): Promise<Asset>;
unpublish(): Promise<Asset>;
update(): Promise<Asset>;
}Hierarchy (view full)
Index
Properties
Interface Asset
fields: {
description?: {
[key: string]: string;
};
file: {
[key: string]: {
contentType: string;
details?: Record<string, any>;
fileName: string;
upload?: string;
uploadFrom?: Record<string, any>;
url?: string;
};
};
title: {
[key: string]: string;
};
};
metadata?: MetadataProps;
sys: EntityMetaSysProps;
archive(): Promise<Asset>;
delete(): Promise<void>;
isArchived(): boolean;
isDraft(): boolean;
isPublished(): boolean;
isUpdated(): boolean;
processForAllLocales(options?: AssetProcessingForLocale): Promise<Asset>;
processForLocale(locale: string, Options?: AssetProcessingForLocale): Promise<Asset>;
publish(): Promise<Asset>;
toPlainObject(): AssetProps;
unarchive(): Promise<Asset>;
unpublish(): Promise<Asset>;
update(): Promise<Asset>;
}Hierarchy (view full)
Index
Properties
Methods
file
Optional
upload?: stringOptional
uploadOptional
url?: stringtitle: {
[key: string]: string;
}[key: string]: string
Optional
metadatasys
Methods
archive
[key: string]: string
Optional
metadatasys
delete
is
is
is
is
process
is
is
is
is
process
Parameters
Optional
options: AssetProcessingForLocaleReturns Promise<Asset>
Throws
process
process
Parameters
Optional
Options: AssetProcessingForLocaleReturns Promise<Asset>
Throws
publish
publish
to
Returns AssetProps
unarchive
to
Returns AssetProps
unarchive
unpublish
unpublish
update
update
A JWT describing a policy; needs to be attached to signed URLs
-A secret key to be used for signing URLs
-A secret key to be used for signing URLs
+The object returned by the BulkActions API
-The object returned by the BulkActions API
+Optional
errorerror information, if present
-original payload when BulkAction was created
-Performs a new GET request and returns the wrapper BulkAction
-Waits until the BulkAction is in one of the final states (succeeded
or failed
) and returns it.
Optional
options: AsyncActionProcessingOptionsOptional
errorerror information, if present
+original payload when BulkAction was created
+Performs a new GET request and returns the wrapper BulkAction
+Waits until the BulkAction is in one of the final states (succeeded
or failed
) and returns it.
Optional
options: AsyncActionProcessingOptionsThe object returned by the BulkActions API
-The object returned by the BulkActions API
+Base interface for all Payload interfaces. Used as part of the MakeRequestOptions to simplify payload definitions.
-Base interface for all Payload interfaces. Used as part of the MakeRequestOptions to simplify payload definitions.
+Base interface for all Payload interfaces. Used as part of the MakeRequestOptions to simplify payload definitions.
-Base interface for all Payload interfaces. Used as part of the MakeRequestOptions to simplify payload definitions.
+Base interface for all Payload interfaces. Used as part of the MakeRequestOptions to simplify payload definitions.
-Base interface for all Payload interfaces. Used as part of the MakeRequestOptions to simplify payload definitions.
+Optional
allowedOptional
apiOptional
defaultOptional
deletedOptional
disabledOptional
itemsOptional
linkOptional
omittedOptional
validationsOptional
allowedOptional
apiOptional
defaultOptional
deletedOptional
disabledOptional
itemsOptional
linkOptional
omittedOptional
validationsField used as the main display field for Entries
-All the fields contained in this Content Type
-Optional
metadataField used as the main display field for Entries
+All the fields contained in this Content Type
+Optional
metadataGets the editor interface for the object
+```" aria-label="Permalink" class="tsd-anchor-icon">
Gets the editor interface for the object
Important note: The editor interface only represent a published contentType.
To get the most recent representation of the contentType make sure to publish it first
Object returned from the server with the current editor interface.
@@ -128,7 +128,7 @@ .then((contentType) => contentType.getEditorInterface()) .then((editorInterface) => console.log(editorInterface.contorls)) .catch(console.error) -```" aria-label="Permalink" class="tsd-anchor-icon">Gets a snapshot of a contentType
+```" aria-label="Permalink" class="tsd-anchor-icon">Gets a snapshot of a contentType
Id of the snapshot
Gets all snapshots of a contentType
+```" aria-label="Permalink" class="tsd-anchor-icon">Gets all snapshots of a contentType
Omits and deletes a field if it exists on the contentType. This is a convenience method which does both operations at once and potentially less +```" aria-label="Permalink" class="tsd-anchor-icon">
Omits and deletes a field if it exists on the contentType. This is a convenience method which does both operations at once and potentially less safe than the standard way. See note about deleting fields on the Update method.
Object returned from the server with updated metadata.
-Publishes the object
+Publishes the object
Object returned from the server with updated metadata.
Unpublishes the object
+```" aria-label="Permalink" class="tsd-anchor-icon">Unpublishes the object
Object returned from the server with updated metadata.
Sends an update to the server with any changes made to the object's properties.
+```" aria-label="Permalink" class="tsd-anchor-icon">
Sends an update to the server with any changes made to the object's properties.
Important note about deleting fields: The standard way to delete a field is with two updates: first omit the property from your responses (set the field attribute "omitted" to true), and then
delete it by setting the attribute "deleted" to true. See the "Deleting fields" section in the
API reference for more reasoning. Alternatively,
@@ -419,4 +419,4 @@
})
.then(contentType => console.log(contentType))
.catch(console.error)
-```" aria-label="Permalink" class="tsd-anchor-icon">
Optional
assetOptional
assetOptional
dateOptional
enabledOptional
enabledOptional
inOptional
linkOptional
linkOptional
messageOptional
nodesOptional
prohibitOptional
rangeOptional
regexpOptional
sizeOptional
uniqueOptional
assetOptional
assetOptional
dateOptional
enabledOptional
enabledOptional
inOptional
linkOptional
linkOptional
messageOptional
nodesOptional
prohibitOptional
rangeOptional
regexpOptional
sizeOptional
uniqueOptional
settingsInstance parameter values
+Optional
widgetID of the widget used
+Optional
widgetType of the widget used
+Optional
pagesOptional
pagesOptional
settingsInstance parameter values
+ID of the widget used
+Type of the widget used
+Optional
controlsArray of fields and their associated widgetId
-Optional
editorLegacy singular editor override
-Optional
editorArray of editor layout field groups
-Optional
editorsArray of editors. Defaults will be used if property is missing.
-Optional
groupArray of field groups and their associated widgetId
-Optional
sidebarArray of sidebar widgets. Defaults will be used if property is missing.
-Gets a control for a specific field
+Optional
editorLegacy singular editor override
+Optional
editorArray of editor layout field groups
+Optional
editorsArray of editors. Defaults will be used if property is missing.
+Optional
groupArray of field groups and their associated widgetId
+Optional
sidebarArray of sidebar widgets. Defaults will be used if property is missing.
+Gets a control for a specific field
control object for specific field
const contentful = require('contentful-management')
const client = contentful.createClient({
accessToken: '<content_management_api_key>'
})
client.getSpace('<space_id>')
.then((space) => space.getEnvironment('<environment_id>'))
.then((environment) => environment.getContentType('<contentType_id>'))
.then((contentType) => contentType.getEditorInterface())
.then((editorInterface) => {
control = editorInterface.getControlForField('<field-id>')
console.log(control)
})
.catch(console.error)
-Sends an update to the server with any changes made to the object's properties
+Sends an update to the server with any changes made to the object's properties
Object returned from the server with updated changes.
const contentful = require('contentful-management')
const client = contentful.createClient({
accessToken: '<content_management_api_key>'
})
client.getSpace('<space_id>')
.then((space) => space.getEnvironment('<environment_id>'))
.then((environment) => environment.getContentType('<contentType_id>'))
.then((contentType) => contentType.getEditorInterface())
.then((editorInterface) => {
editorInterface.controls[0] = { "fieldId": "title", "widgetId": "singleLine"}
editorInterface.editors = [
{ "widgetId": "custom-widget", "widgetNamespace": "app" }
]
return editorInterface.update()
})
.catch(console.error)
-Optional
controlsArray of fields and their associated widgetId
-Optional
editorLegacy singular editor override
-Optional
editorArray of editor layout field groups
-Optional
editorsArray of editors. Defaults will be used if property is missing.
-Optional
groupArray of field groups and their associated widgetId
-Optional
sidebarArray of sidebar widgets. Defaults will be used if property is missing.
-Optional
controlsArray of fields and their associated widgetId
+Optional
editorLegacy singular editor override
+Optional
editorArray of editor layout field groups
+Optional
editorsArray of editors. Defaults will be used if property is missing.
+Optional
groupArray of field groups and their associated widgetId
+Optional
sidebarArray of sidebar widgets. Defaults will be used if property is missing.
+Optional
archivedOptional
archivedOptional
archivedOptional
archivedOptional
archivedOptional
archivedOptional
createdOptional
deletedOptional
deletedOptional
deletedOptional
firstOptional
localeOptional
publishedOptional
publishedOptional
publishedOptional
publishedOptional
statusOptional
createdOptional
deletedOptional
deletedOptional
deletedOptional
firstOptional
localeOptional
publishedOptional
publishedOptional
publishedOptional
publishedOptional
statusOptional
updatedOptional
updatedCreates a new comment for an entry
+```" aria-label="Permalink" class="tsd-anchor-icon">Creates a new comment for an entry
Object representation of the Comment to be created
Promise for the newly created Comment
Creates a new task for an entry
+```" aria-label="Permalink" class="tsd-anchor-icon">Creates a new task for an entry
Object representation of the Task to be created
Promise for the newly created Task
Deletes this object on the server.
+```" aria-label="Permalink" class="tsd-anchor-icon">Deletes this object on the server.
Promise for the deletion. It contains no data, but the Promise error case should be handled.
Gets a comment of an entry
+```" aria-label="Permalink" class="tsd-anchor-icon">Gets a comment of an entry
Gets all comments of an entry
+Gets all comments of an entry
const contentful = require('contentful-management')
const client = contentful.createClient({ accessToken: '<content_management_api_key>' @@ -292,7 +292,7 @@
-Gets a snapshot of an entry
+Gets a snapshot of an entry
Id of the snapshot
Gets all snapshots of an entry
+```" aria-label="Permalink" class="tsd-anchor-icon">Gets all snapshots of an entry
Gets a task of an entry
+```" aria-label="Permalink" class="tsd-anchor-icon">Gets a task of an entry
Gets all tasks of an entry
+Gets all tasks of an entry
const contentful = require('contentful-management')
const client = contentful.createClient({ accessToken: '<content_management_api_key>' @@ -427,11 +427,11 @@
-Checks if entry is archived. This means it's not exposed to the Delivery/Preview APIs.
-Checks if the entry is in draft mode. This means it is not published.
-Checks if the entry is published. A published entry might have unpublished changes
-Checks if the entry is updated. This means the entry was previously published but has unpublished changes.
-Optional
metadataSends an JSON patch to the server with any changes made to the object's properties
+Checks if entry is archived. This means it's not exposed to the Delivery/Preview APIs.
+Checks if the entry is in draft mode. This means it is not published.
+Checks if the entry is published. A published entry might have unpublished changes
+Checks if the entry is updated. This means the entry was previously published but has unpublished changes.
+Optional
metadataSends an JSON patch to the server with any changes made to the object's properties
Publishes the object
+```" aria-label="Permalink" class="tsd-anchor-icon">Publishes the object
Recursively collects references of an entry and their descendants
-Unarchives the object
+```" aria-label="Permalink" class="tsd-anchor-icon">Recursively collects references of an entry and their descendants
+Unarchives the object
Unpublishes the object
+```" aria-label="Permalink" class="tsd-anchor-icon">Unpublishes the object
Sends an update to the server with any changes made to the object's properties
+```" aria-label="Permalink" class="tsd-anchor-icon">Sends an update to the server with any changes made to the object's properties
Optional
archivedOptional
archivedOptional
archivedOptional
archivedOptional
archivedOptional
archivedOptional
createdOptional
deletedOptional
deletedOptional
deletedOptional
firstOptional
localeOptional
publishedOptional
publishedOptional
publishedOptional
publishedOptional
statusOptional
createdOptional
deletedOptional
deletedOptional
deletedOptional
firstOptional
localeOptional
publishedOptional
publishedOptional
publishedOptional
publishedOptional
statusOptional
updatedOptional
updatedDeletes this object on the server.
Promise for the deletion. It contains no data, but the Promise error case should be handled.
const contentful = require('contentful-management')
const client = contentful.createClient({
accessToken: '<content_management_api_key>'
})
client.getSpace('<space_id>')
.then((space) => space.getEnvironmentAlias('<environment_alias_id>'))
.then((alias) => {
return alias.delete()
})
.then(() => console.log(`Alias deleted.`))
.catch(console.error)
Sends an update to the server with any changes made to the object's properties. Currently, you can only change the id of the alias's underlying environment. See the example below.
+Sends an update to the server with any changes made to the object's properties. Currently, you can only change the id of the alias's underlying environment. See the example below.
Object returned from the server with updated changes.
const contentful = require('contentful-management')
const client = contentful.createClient({
accessToken: '<content_management_api_key>'
})
client.getSpace('<space_id>')
.then((space) => space.getEnvironmentAlias('<environment_alias_id>'))
.then((alias) => {
alias.environment.sys.id = '<environment_id>'
return alias.update()
})
.then((alias) => console.log(`alias ${alias.sys.id} updated.`))
.catch(console.error)
Optional
settingsInstance parameter values
+Optional
widgetID of the widget used
+Optional
widgetType of the widget used
+Link is a reference object to another entity that can be resolved using tools such as contentful-resolve
-Link is a reference object to another entity that can be resolved using tools such as contentful-resolve
+Locale code (example: en-us)
-If the content under this locale should be available on the CDA (for public reading)
-If the content under this locale should be available on the CMA (for editing)
-If this is the default locale
-Locale code to fallback to when there is not content for the current locale
-Internal locale code
-Locale name
-If the locale needs to be filled in on entries or not
-If the content under this locale should be available on the CDA (for public reading)
+If the content under this locale should be available on the CMA (for editing)
+If this is the default locale
+Locale code to fallback to when there is not content for the current locale
+Internal locale code
+Locale name
+If the locale needs to be filled in on entries or not
+Sends an update to the server with any changes made to the object's properties
+```" aria-label="Permalink" class="tsd-anchor-icon">Optional
headersOptional
paramsOptional
payloadOptional
headersOptional
paramsOptional
payloadBase interface for all Payload interfaces. Used as part of the MakeRequestOptions to simplify payload definitions.
-Base interface for all Payload interfaces. Used as part of the MakeRequestOptions to simplify payload definitions.
+Optional
archivedOptional
archivedOptional
archivedOptional
createdOptional
deletedOptional
deletedOptional
deletedOptional
publishedOptional
spaceOptional
statusOptional
archivedOptional
archivedOptional
archivedOptional
createdOptional
deletedOptional
deletedOptional
deletedOptional
publishedOptional
spaceOptional
statusOptional
updatedOptional
updatedSends an update to the server with any changes made to the object's properties
+Sends an update to the server with any changes made to the object's properties
Object returned from the server with updated changes.
Optional
tokenRevokes a personal access token
+Optional
tokenRevokes a personal access token
Object the revoked personal access token
The object returned by the Releases API
-The object returned by the Releases API
+Archives a release and locks any actions such as adding new entities or publishing/unpublishing. +
Publishes a Release and waits until the asynchronous action is completed
-Optional
options: AsyncActionProcessingOptionsUnarchives an archived
release and unlocks operations on the Release. This operation increases the sys.version property
Publishes a Release and waits until the asynchronous action is completed
+Optional
options: AsyncActionProcessingOptionsUnpublishes a Release and waits until the asynchronous action is completed
-Optional
options: AsyncActionProcessingOptionsUpdates a Release and returns the updated Release object
-Validates a Release and waits until the asynchronous action is completed
-Optional
__namedParameters: { Optional
options?: AsyncActionProcessingOptionsOptional
payload?: ReleaseValidatePayloadUnpublishes a Release and waits until the asynchronous action is completed
+Optional
options: AsyncActionProcessingOptionsUpdates a Release and returns the updated Release object
+Validates a Release and waits until the asynchronous action is completed
+Optional
__namedParameters: { Optional
options?: AsyncActionProcessingOptionsOptional
payload?: ReleaseValidatePayloadThe object returned by the Releases API
-The object returned by the Releases API
+Performs a new GET request and returns the wrapper Release
-Waits until the Release Action has either succeeded or failed
-Optional
options: AsyncActionProcessingOptionsPerforms a new GET request and returns the wrapper Release
+Waits until the Release Action has either succeeded or failed
+Optional
options: AsyncActionProcessingOptionsThe object returned by the Releases API
-The object returned by the Releases API
+Optional
actionOptional
limitLimit of how many records are returned in the query result
Optional
orderOptional
orderOptional
sys.id[in]Find Release Actions by using a comma-separated list of Ids
-Optional
sys.release.sys.id[in]Optional
sys.status[in]Optional
sys.status[nin]Optional
uniqueGet unique results by this field. Currently supports sys.release.sys.id
Optional
sys.id[in]Find Release Actions by using a comma-separated list of Ids
+Optional
sys.release.sys.id[in]Optional
sys.status[in]Optional
sys.status[nin]Optional
uniqueGet unique results by this field. Currently supports sys.release.sys.id
Base interface for all Payload interfaces. Used as part of the MakeRequestOptions to simplify payload definitions.
-Base interface for all Payload interfaces. Used as part of the MakeRequestOptions to simplify payload definitions.
+The object returned by the Releases API
-The object returned by the Releases API
+Optional
entities.sys.id[in]Find releases containing the specified, comma-separated entities. Requires entities.sys.linkType
Optional
entities.sys.linkFind releases filtered by the Entity type (Asset, Entry)
-Optional
entities[exists]Filter by empty Releases (exists=false) or Releases with items (exists=true)
-Optional
limitLimit how many records are returned in the result
+Optional
entities.sys.linkFind releases filtered by the Entity type (Asset, Entry)
+Optional
entities[exists]Filter by empty Releases (exists=false) or Releases with items (exists=true)
+Optional
limitLimit how many records are returned in the result
Optional
orderOrder releases +
Optional
orderOrder releases Supported values include
title
, -title
Optional
pageIf present, will return results based on a pagination cursor
-Optional
sys.createdComma-separated list of user Ids to find releases by creator
-Optional
sys.id[in]Comma-separated list of Ids to find (inclusion)
-Optional
sys.id[nin]Comma-separated list of ids to exclude from the query
-Optional
sys.status[in]Comma-separated filter (inclusion) by Release status (active, archived)
-Optional
sys.status[nin]Comma-separated filter (exclusion) by Release status (active, archived)
-Optional
title[match]Find releases using full text phrase and term matching
-Optional
pageIf present, will return results based on a pagination cursor
+Optional
sys.createdComma-separated list of user Ids to find releases by creator
+Optional
sys.id[in]Comma-separated list of Ids to find (inclusion)
+Optional
sys.id[nin]Comma-separated list of ids to exclude from the query
+Optional
sys.status[in]Comma-separated filter (inclusion) by Release status (active, archived)
+Optional
sys.status[nin]Comma-separated filter (exclusion) by Release status (active, archived)
+Optional
title[match]Find releases using full text phrase and term matching
+ResourceLink is a reference object to another entity outside of the current space/environment
-ResourceLink is a reference object to another entity outside of the current space/environment
+Link to a Contentful function
-System metadata
-Resource Provider type, value is 'function'
-System metadata
+Resource Provider type, value is 'function'
+Resource Type defaultFieldMapping
-Resource Type name
-System metadata
-Resource Type name
+System metadata
+Optional
descriptionPermissions for application sections
-Optional
descriptionPermissions for application sections
+Sends an update to the server with any changes made to the object's properties
+```" aria-label="Permalink" class="tsd-anchor-icon">Optional
environmentOptional
errorThe Contentful-style error that occurred during execution if sys.status is failed
Optional
payloadOptional
timezone?: stringA valid IANA timezone Olson identifier
+Optional
payloadOptional
timezone?: stringA valid IANA timezone Olson identifier
Optional
settingsInstance parameter values
+ID of the widget used
+Type of the widget used
+Array of Role Links
+Sends an update to the server with any changes made to the object's properties
+```" aria-label="Permalink" class="tsd-anchor-icon">Sends an update to the server with any changes made to the object's properties
Object returned from the server with updated changes.
Description of the team
-Name of the team
-System metadata
-Sends an update to the server with any changes made to the object's properties
+```" aria-label="Permalink" class="tsd-anchor-icon">Is admin
-Organization membership id
-System metadata
-Organization membership id
+System metadata
+Sends an update to the server with any changes made to the object's properties
+```" aria-label="Permalink" class="tsd-anchor-icon">Sends an update to the server with any changes made to the object's properties
Object returned from the server with updated changes.
Sends an update to the server with any changes made to the object's properties
+```" aria-label="Permalink" class="tsd-anchor-icon">Sends an update to the server with any changes made to the object's properties
Object returned from the server with updated changes.
System metadata
-System metadata
+Optional
installation?: ParameterDefinition<InstallationParameterType>[]Optional
instance?: ParameterDefinition<ParameterType>[]Optional
sidebar?: booleanControls the location of the extension. If true it will be rendered on the sidebar instead of replacing the field's editing control
Optional
src?: stringURL where the root HTML document of the extension can be found
Optional
srcdoc?: stringString representation of the extension (e.g. inline HTML code)
-Optional
parametersValues for installation parameters
-Optional
parametersValues for installation parameters
+Sends an update to the server with any changes made to the object's properties
+```" aria-label="Permalink" class="tsd-anchor-icon">Sends an update to the server with any changes made to the object's properties
Object returned from the server with updated changes.
Deletes this object on the server.
Promise for the deletion. It contains no data, but the Promise error case should be handled.
const contentful = require('contentful-management')
const client = contentful.createClient({
accessToken: '<content_management_api_key>'
})
client.getSpace('<space_id>')
.then((space) => space.getEnvironment('<environment_id>'))
.then((environment) => environment.getUpload('<upload_id>'))
.then((upload) => upload.delete())
.then((upload) => console.log(`upload ${upload.sys.id} updated.`))
.catch(console.error)
-creates the upload credentials.
+creates the upload credentials.
upload credentials for file uploads
const contentful = require('contentful-management')
const client = contentful.createClient({
accessToken: '<content_management_api_key>'
})
try {
const space = await client.getSpace('<space_id>')
const environment = await space.getEnvironment('<environment_id>')
const upload = await client.uploadCredential.create({
spaceId: space.sys.id,
environmentId: environment.sys.id
})
} catch (error) {
console.error(error)
}
-Range of usage
-Type of usage
-System metadata
-Unit of usage metric
-Value of the usage
-Usage per day
-Type of usage
+System metadata
+Unit of usage metric
+Value of the usage
+Usage per day
+Activation flag
-Url to the users avatar
-User confirmation flag
-Email address of the user
-First name of the user
-Last name of the user
-Number of sign ins
-System metadata
-Activation flag
+Url to the users avatar
+User confirmation flag
+Email address of the user
+First name of the user
+Last name of the user
+Number of sign ins
+System metadata
+System metadata
-System metadata
+Whether the Webhook is active. If set to false, no calls will be made
-Optional
filtersWebhook filters
-Headers that should be appended to the webhook request
-Optional
httpPassword for basic http auth
-Optional
httpUsername for basic http auth
-Webhook name
-System metadata
-Topics the webhook wants to subscribe to
-Optional
transformationTransformation to apply
-Webhook url
-Optional
filtersWebhook filters
+Headers that should be appended to the webhook request
+Optional
httpPassword for basic http auth
+Optional
httpUsername for basic http auth
+Webhook name
+System metadata
+Topics the webhook wants to subscribe to
+Optional
transformationTransformation to apply
+Webhook url
+Deletes this object on the server.
Promise for the deletion. It contains no data, but the Promise error case should be handled.
const contentful = require('contentful-management')
const client = contentful.createClient({
accessToken: '<content_management_api_key>'
})
client.getSpace('<space_id>')
.then((space) => space.getWebhook('<webhook_id>'))
.then((webhook) => webhook.delete())
.then((webhook) => console.log(`webhook ${webhook.sys.id} updated.`))
.catch(console.error)
-Webhook call with specific id. See https://www.contentful.com/developers/docs/references/content-management-api/#/reference/webhook-calls/webhook-call-overviews for more details
+Webhook call with specific id. See https://www.contentful.com/developers/docs/references/content-management-api/#/reference/webhook-calls/webhook-call-overviews for more details
Promise for call details
const contentful = require('contentful-management')
const client = contentful.createClient({
accessToken: '<content_management_api_key>'
})
client.getSpace('<space_id>')
.then((space) => space.getWebhook('<webhook_id>'))
.then((webhook) => webhook.getCall('<call-id>'))
.then((webhookCall) => console.log(webhookCall))
.catch(console.error)
-List of the most recent webhook calls. See https://www.contentful.com/developers/docs/references/content-management-api/#/reference/webhook-calls/webhook-call-overviews for more details.
+List of the most recent webhook calls. See https://www.contentful.com/developers/docs/references/content-management-api/#/reference/webhook-calls/webhook-call-overviews for more details.
Promise for list of calls
const contentful = require('contentful-management')
const client = contentful.createClient({
accessToken: '<content_management_api_key>'
})
client.getSpace('<space_id>')
.then((space) => space.getWebhook('<webhook_id>'))
.then((webhook) => webhook.getCalls())
.then((response) => console.log(response.items)) // webhook calls
.catch(console.error)
-Overview of the health of webhook calls. See https://www.contentful.com/developers/docs/references/content-management-api/#/reference/webhook-calls/webhook-call-overviews for more details.
+Overview of the health of webhook calls. See https://www.contentful.com/developers/docs/references/content-management-api/#/reference/webhook-calls/webhook-call-overviews for more details.
Promise for health info
const contentful = require('contentful-management')
const client = contentful.createClient({
accessToken: '<content_management_api_key>'
})
client.getSpace('<space_id>')
.then((space) => space.getWebhook('<webhook_id>'))
.then((webhook) => webhook.getHealth())
.then((webhookHealth) => console.log(webhookHealth))
.catch(console.error)
-Sends an update to the server with any changes made to the object's properties
+Sends an update to the server with any changes made to the object's properties
Object returned from the server with updated changes.
const contentful = require('contentful-management')
const client = contentful.createClient({
accessToken: '<content_management_api_key>'
})
client.getSpace('<space_id>')
.then((space) => space.getWebhook('<webhook_id>'))
.then((webhook) => {
webhook.name = 'new webhook name'
return webhook.update()
})
.then((webhook) => console.log(`webhook ${webhook.sys.id} updated.`))
.catch(console.error)
-Optional
appliesOptional
descriptionOptional
flowOptional
startOptional
appliesOptional
descriptionOptional
flowOptional
startContentful Management API SDK. Allows you to create instances of a client +
Contentful Management API SDK. Allows you to create instances of a client with access to the Contentful Content Management API.
System metadata
+System metadata
Token for an app installation in a space environment
-System metadata
-System metadata
+Optional
description?: stringHuman readable description of the action
+Optional
description?: stringHuman readable description of the action
Human readable name for the action
System metadata
Optional
type?: AppActionTypeType of the action, defaults to endpoint if not provided @@ -6,4 +6,4 @@ function: deprecated, use function-invocation instead function-invocation: action invokes a contentful function
Url that will be called when the action is invoked
-Optional
comment?: stringA comment that describes this bundle
+Optional
comment?: stringA comment that describes this bundle
List of all the files that are in this bundle
System metadata
-Optional
bundle?: Link<"AppBundle">Link to an AppBundle
+Optional
bundle?: Link<"AppBundle">Link to an AppBundle
Optional
locations?: AppLocation[]Locations where the app can be installed
App name
Optional
parameters?: { Instance parameter definitions
Optional
installation?: ParameterDefinition<InstallationParameterType>[]Optional
instance?: ParameterDefinition[]Optional
src?: stringURL where the root HTML document of the app can be found
System metadata
-Optional
icon?: AppIconSystem metadata
+System metadata
Subscription url that will receive events
List of topics to subscribe to
-Optional
parameters?: FreeFormParametersFree-form installation parameters (API limits stringified length to 32KB)
-Optional
parameters?: FreeFormParametersFree-form installation parameters (API limits stringified length to 32KB)
+Optional
generated?: { If generated, private key is returned
+Optional
generated?: { If generated, private key is returned
Base64 PEM
JSON Web Key
System metadata
-new headers to be included in the request
+new headers to be included in the request
System metadata
-The last four characters of the signing secret
+The last four characters of the signing secret
System metadata
-A JWT describing a policy; needs to be attached to signed URLs
+A JWT describing a policy; needs to be attached to signed URLs
A secret key to be used for signing URLs
-Optional
description?: { Description for this asset
+Optional
description?: { Description for this asset
File object for this asset
Optional
details?: Record<string, any>Details for the file, depending on file type (example: image size in bytes, etc)
Optional
upload?: stringUrl where the file is available to be downloaded from, into the Contentful asset system. After the asset is processed this field is gone.
Optional
uploadOptional
url?: stringUrl where the file is available at the Contentful media asset system. This field won't be available until the asset is processed.
Title for this asset
-Optional
metadata?: MetadataPropsOptional
metadata?: MetadataPropsField used as the main display field for Entries
+Field used as the main display field for Entries
All the fields contained in this Content Type
-Optional
metadata?: ContentTypeMetadataOptional
metadata?: ContentTypeMetadataJSON Web Token
-JSON Web Token
+The body for the call
-The body for the call
+Optional
generate?: booleanToggle for automatic private key generation
+Optional
generate?: booleanToggle for automatic private key generation
Optional
jwk?: JWKJSON Web Key, required if generate is falsy
-Optional
body?: stringoptional stringified body of the request
+Optional
body?: stringoptional stringified body of the request
Optional
headers?: Record<string, string>optional headers of the request
the request method
the path of the request method
-A 64 character matching the regular expression /^[0-9a-zA-Z+/=_-]+$/
-A 64 character matching the regular expression /^[0-9a-zA-Z+/=_-]+$/
+(required) UNIX timestamp in the future (but not more than 48 hours from now)
-(required) UNIX timestamp in the future (but not more than 48 hours from now)
+Optional
controls?: Control[]Array of fields and their associated widgetId
+Optional
controls?: Control[]Array of fields and their associated widgetId
Optional
editor?: EditorLegacy singular editor override
Optional
editorArray of editor layout field groups
Optional
editors?: Editor[]Array of editors. Defaults will be used if property is missing.
Optional
groupArray of field groups and their associated widgetId
Optional
sidebar?: SidebarItem[]Array of sidebar widgets. Defaults will be used if property is missing.
-System meta data
-System meta data
+Name of the environment
+Name of the environment
System metadata
-String will be in ISO8601 datetime format e.g. 2013-06-26T13:57:24Z
-String will be in ISO8601 datetime format e.g. 2013-06-26T13:57:24Z
+Locale code (example: en-us)
+Locale code (example: en-us)
If the content under this locale should be available on the CDA (for public reading)
If the content under this locale should be available on the CMA (for editing)
If this is the default locale
@@ -6,4 +6,4 @@Internal locale code
Locale name
If the locale needs to be filled in on entries or not
-Role
+Role
status
System metadata
-Name
+Name
System metadata
-Link to a Contentful function
+Link to a Contentful function
System metadata
Resource Provider type, value is 'function'
-Resource Type defaultFieldMapping
+Resource Type defaultFieldMapping
Optional
badge?: { Optional
description?: stringOptional
externalOptional
image?: { Optional
altOptional
subtitle?: stringResource Type name
System metadata
-Optional
description?: stringPermissions for application sections
-Optional
description?: stringPermissions for application sections
+Optional
environment?: { Optional
error?: ScheduledActionFailedErrorThe Contentful-style error that occurred during execution if sys.status is failed
+Optional
environment?: { Optional
error?: ScheduledActionFailedErrorThe Contentful-style error that occurred during execution if sys.status is failed
Optional
canceledan ISO8601 date string representing when an action was moved to canceled
+Optional
canceledan ISO8601 date string representing when an action was moved to canceled
Optional
canceledan ISO8601 date string representing when an action was updated
-User is an admin
+User is an admin
Array of Role Links
-Is admin
+Is admin
Organization membership id
System metadata
-Description of the team
+Description of the team
Name of the team
System metadata
-Is admin
+Is admin
Roles
System metadata
-System metadata
-System metadata
+Field types where an extension can be used
+Field types where an extension can be used
Extension name
Optional
parameters?: { Parameter definitions
Optional
installation?: ParameterDefinition<InstallationParameterType>[]Optional
instance?: ParameterDefinition[]Optional
sidebar?: booleanControls the location of the extension. If true it will be rendered on the sidebar instead of replacing the field's editing control
Optional
src?: stringURL where the root HTML document of the extension can be found
Optional
srcdoc?: stringString representation of the extension (e.g. inline HTML code)
Optional
parameters?: DefinedParametersValues for installation parameters
-System metadata
-System metadata
+System metadata
-System metadata
+Range of usage
+Range of usage
Type of usage
System metadata
Unit of usage metric
Value of the usage
Usage per day
-Activation flag
+Activation flag
Url to the users avatar
User confirmation flag
Email address of the user
@@ -6,4 +6,4 @@Last name of the user
Number of sign ins
System metadata
-System metadata
-System metadata
+Whether the Webhook is active. If set to false, no calls will be made
+Whether the Webhook is active. If set to false, no calls will be made
Optional
filters?: WebhookFilter[]Webhook filters
Headers that should be appended to the webhook request
Optional
httpPassword for basic http auth
@@ -8,4 +8,4 @@Topics the webhook wants to subscribe to
Optional
transformation?: WebhookTransformationTransformation to apply
Webhook url
-Optional
order?: OrderQueryParamOrder workflows by
+Optional
order?: OrderQueryParamOrder workflows by
Optional
stepOptional
sys.entity.sys.id[in]?: stringFind workflows containing the specified, comma-separated entities. Requires sys.entity.sys.linkType
Optional
sys.entity.sys.linkFind workflows filtered by the Entity type (Entry)
-Optional
sys.workflowOptional
sys.workflowFind workflows changelog entries containing the specified, comma-separated entities. Requires sys.entity.sys.linkType
Find workflows changelog entries containing the specified, comma-separated entities. Requires sys.entity.sys.linkType
Find workflows changelog entries filtered by the Entity type (Entry)
Optional
eventOptional
eventOptional
workflow.sys.id?: stringworkflow.sys.id is optional so all past workflows can be found
-Optional
workflowOptional
workflow
Represents the state of the BulkAction
+