Sign in
Connectors

Create connector mapping

Creates a connector mapping.

post/v1/connector-targets/{connectorTargetId}/mappings

Path parameters

connectorTargetIdstring typeid required

Den TypeID with 'ctg_' prefix and a 26-character base32 suffix.

Request body

mappingKind'path' | 'api' | 'custom' required
selectorstring required
objectType'skill' | 'agent' | 'command' | 'tool' | 'mcp' | 'hook' | 'context' | 'custom' | 'script' | 'workflow' | 'app' required
pluginIdstring typeid nullable

Den TypeID with 'plg_' prefix and a 26-character base32 suffix.

autoAddToPluginboolean
configobject

Response

Connector mapping created successfully.

oktrue required

Changes

Changed in 3 of the 25 revisions of this API.39

  • 93df40e2efd517See the full diff
    • ●

      added the new workflow enum value to the item/objectType response property for the response status 201

      response-property-enum-value-added

    • ○

      removed the pattern ^ctg_.* from the path request parameter connectorTargetId

      request-parameter-pattern-removed

    • ○

      added the new workflow enum value to the request property objectType

      request-property-enum-value-added

    • ○

      removed the pattern ^plg_.* from the request property pluginId/anyOf[subschema #1]/

      request-property-pattern-removed

    • ○

      the item/connectorInstanceId response's property pattern ^cin_.* was removed for the status 201

      response-property-pattern-removed

    • ○

      the item/connectorTargetId response's property pattern ^ctg_.* was removed for the status 201

      response-property-pattern-removed

    • ○

      the item/id response's property pattern ^cmp_.* was removed for the status 201

      response-property-pattern-removed

    • ○

      the item/pluginId/anyOf[subschema #1]/ response's property pattern ^plg_.* was removed for the status 201

      response-property-pattern-removed

    This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

  • 6915dfb03e5d11See the full diff
    • ●

      added the new app enum value to the item/objectType response property for the response status 201

      response-property-enum-value-added

    • ○

      added the new app enum value to the request property objectType

      request-property-enum-value-added

  • 54cdbd4ecffa11See the full diff
    • ●

      added the new script enum value to the item/objectType response property for the response status 201

      response-property-enum-value-added

    • ○

      added the new script enum value to the request property objectType

      request-property-enum-value-added