Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
A direct command skips the review prompt. Inspect the source before running it.
Updates some of the configuration choices of a particular source API association.
apis
Method
Path
Description
POST
/v1/apis/{apiId}/ApiCaches
Creates a cache for the GraphQL API.
POST
/v1/apis/{apiId}/apikeys
Creates a unique key that you can distribute to clients who invoke your API.
POST
/v1/apis/{apiId}/datasources
Creates a DataSource object.
POST
/v1/apis/{apiId}/functions
Creates a Function object. A function is a reusable entity. You can use multiple functions to compose the resolver logic.
POST
/v1/apis
Creates a GraphqlApi object.
POST
/v1/apis/{apiId}/types/{typeName}/resolvers
Creates a Resolver object. A resolver converts incoming requests into a format that a data source can understand, and converts the data source's responses into GraphQL.
Retrieves the list of environmental variable key-value pairs associated with an API by its ID value.
dataplane-evaluatecode
Method
Path
Description
POST
/v1/dataplane-evaluatecode
Evaluates the given code and returns the response. The code definition requirements depend on the specified runtime. For APPSYNC_JS runtimes, the code defines the request and response functions. The request function takes the incoming request after a GraphQL operation is parsed and converts it into a request configuration for the selected data source operation. The response function interprets responses from the data source and maps it to the shape of the GraphQL field output type.
dataplane-evaluatetemplate
Method
Path
Description
POST
/v1/dataplane-evaluatetemplate
Evaluates a given template and returns the response. The mapping template can be a request or response template. Request templates take the incoming request after a GraphQL operation is parsed and convert it into a request configuration for the selected data source operation. Response templates interpret responses from the data source and map it to the shape of the GraphQL field output type. Mapping templates are written in the Apache Velocity Template Language (VTL).
datasources
Method
Path
Description
GET
/v1/datasources/introspections/{introspectionId}
Retrieves the record of an existing introspection. If the retrieval is successful, the result of the instrospection will also be returned. If the retrieval fails the operation, an error message will be returned instead.
POST
/v1/datasources/introspections
Creates a new introspection. Returns the introspectionId of the new introspection after its creation.
tags
Method
Path
Description
GET
/v1/tags/{resourceArn}
Lists the tags for a resource.
POST
/v1/tags/{resourceArn}
Tags a resource with user-supplied tags.
DELETE
/v1/tags/{resourceArn}
Untags a resource.
Common Questions
Match user requests to endpoints in references/api-spec.lap. Key patterns:
"Create a apiassociation?" -> POST /v1/domainnames/{domainName}/apiassociation
"Create a mergedApiAssociation?" -> POST /v1/sourceApis/{sourceApiIdentifier}/mergedApiAssociations
"Create a sourceApiAssociation?" -> POST /v1/mergedApis/{mergedApiIdentifier}/sourceApiAssociations
"Create a ApiCache?" -> POST /v1/apis/{apiId}/ApiCaches
"Create a apikey?" -> POST /v1/apis/{apiId}/apikeys
"Create a datasource?" -> POST /v1/apis/{apiId}/datasources
"Create a domainname?" -> POST /v1/domainnames
"Create a function?" -> POST /v1/apis/{apiId}/functions
"Create a apis?" -> POST /v1/apis
"Create a resolver?" -> POST /v1/apis/{apiId}/types/{typeName}/resolvers
"Create a type?" -> POST /v1/apis/{apiId}/types
"Delete a apikey?" -> DELETE /v1/apis/{apiId}/apikeys/{id}
"Delete a datasource?" -> DELETE /v1/apis/{apiId}/datasources/{name}
"Delete a domainname?" -> DELETE /v1/domainnames/{domainName}
"Delete a function?" -> DELETE /v1/apis/{apiId}/functions/{functionId}
"Delete a apis?" -> DELETE /v1/apis/{apiId}
"Delete a resolver?" -> DELETE /v1/apis/{apiId}/types/{typeName}/resolvers/{fieldName}
"Delete a type?" -> DELETE /v1/apis/{apiId}/types/{typeName}
"Delete a mergedApiAssociation?" -> DELETE /v1/sourceApis/{sourceApiIdentifier}/mergedApiAssociations/{associationId}
"Delete a sourceApiAssociation?" -> DELETE /v1/mergedApis/{mergedApiIdentifier}/sourceApiAssociations/{associationId}
"Create a dataplane-evaluatecode?" -> POST /v1/dataplane-evaluatecode
"Create a dataplane-evaluatetemplate?" -> POST /v1/dataplane-evaluatetemplate
"List all apiassociation?" -> GET /v1/domainnames/{domainName}/apiassociation
"List all ApiCaches?" -> GET /v1/apis/{apiId}/ApiCaches
"Get datasource details?" -> GET /v1/apis/{apiId}/datasources/{name}
"Get introspection details?" -> GET /v1/datasources/introspections/{introspectionId}
"Get domainname details?" -> GET /v1/domainnames/{domainName}
"Get function details?" -> GET /v1/apis/{apiId}/functions/{functionId}
"Get apis details?" -> GET /v1/apis/{apiId}
"List all environmentVariables?" -> GET /v1/apis/{apiId}/environmentVariables
"List all schema?" -> GET /v1/apis/{apiId}/schema
"Get resolver details?" -> GET /v1/apis/{apiId}/types/{typeName}/resolvers/{fieldName}
"List all schemacreation?" -> GET /v1/apis/{apiId}/schemacreation
"Get sourceApiAssociation details?" -> GET /v1/mergedApis/{mergedApiIdentifier}/sourceApiAssociations/{associationId}
"Get type details?" -> GET /v1/apis/{apiId}/types/{typeName}
Response Tips
Check response schemas in references/api-spec.lap for field details
Create/update endpoints typically return the created/updated object
References
Full spec: See references/api-spec.lap for complete endpoint details, parameter tables, and response schemas
Retrieves the current status of a schema creation operation.
GET
/v1/apis/{apiId}/types/{typeName}
Retrieves a Type object.
GET
/v1/apis/{apiId}/apikeys
Lists the API keys for a given API. API keys are deleted automatically 60 days after they expire. However, they may still be included in the response until they have actually been deleted. You can safely call DeleteApiKey to manually delete a key before it's automatically deleted.
GET
/v1/apis/{apiId}/datasources
Lists the data sources for a given API.
GET
/v1/apis/{apiId}/functions
List multiple functions.
GET
/v1/apis
Lists your GraphQL APIs.
GET
/v1/apis/{apiId}/types/{typeName}/resolvers
Lists the resolvers for a given API and type.
GET
/v1/apis/{apiId}/functions/{functionId}/resolvers
List the resolvers that are associated with a specific function.
GET
/v1/apis/{apiId}/sourceApiAssociations
Lists the SourceApiAssociationSummary data.
GET
/v1/apis/{apiId}/types
Lists the types for a given API.
PUT
/v1/apis/{apiId}/environmentVariables
Creates a list of environmental variables in an API by its ID value. When creating an environmental variable, it must follow the constraints below: Both JavaScript and VTL templates support environmental variables. Environmental variables are not evaluated before function invocation. Environmental variables only support string values. Any defined value in an environmental variable is considered a string literal and not expanded. Variable evaluations should ideally be performed in the function code. When creating an environmental variable key-value pair, it must follow the additional constraints below: Keys must begin with a letter. Keys must be at least two characters long. Keys can only contain letters, numbers, and the underscore character (_). Values can be up to 512 characters long. You can configure up to 50 key-value pairs in a GraphQL API. You can create a list of environmental variables by adding it to the environmentVariables payload as a list in the format {"key1":"value1","key2":"value2", …}. Note that each call of the PutGraphqlApiEnvironmentVariables action will result in the overwriting of the existing environmental variable list of that API. This means the existing environmental variables will be lost. To avoid this, you must include all existing and new environmental variables in the list each time you call this action.
POST
/v1/apis/{apiId}/schemacreation
Adds a new schema to your GraphQL API. This operation is asynchronous. Use to determine when it has completed.
POST
/v1/apis/{apiId}/ApiCaches/update
Updates the cache for the GraphQL API.
POST
/v1/apis/{apiId}/apikeys/{id}
Updates an API key. You can update the key as long as it's not deleted.
