Skip to content
Docs

Targets

26 operations in the Adverity Connect API. Replace {{INSTANCE}} and {{KEY}} in the examples with your instance and API key. How authentication works.

List target columns

GET/api/target-columns/

API key permissionDestination: Read-onlydestination:read

Query parameters

  • namestring
  • orderingstring

    Which field to use when ordering the results.

  • pageinteger

    A page number within the paginated result set.

  • page_sizeinteger

    Number of results to return per page.

Responses

200OKapplication/json

Response schema

object PaginatedSchemaColumnCompatibilityList

  • countintegerrequired

    Example 123

  • nextstring · urinullable

    Example "http://api.example.org/accounts/?page=4"

  • previousstring · urinullable

    Example "http://api.example.org/accounts/?page=2"

  • resultsarray of objectrequired
    Items · SchemaColumnCompatibility
    • idinteger
    • namestringrequired

      Max length 200

    • usagestring
    • mappingsstring · urirequiredread-only
    • typestringrequired
    • lengthintegernullable

      Min -2147483648 · Max 2147483647

    • measureone of
      Attributes

      • MeasureEnum

      • BlankEnum

      • NullEnum

    • descriptionstringnullable

      Max length 1000

    • urlstring · urirequiredread-only

Create target columns

POST/api/target-columns/

API key permissionDestination: Writedestination:write

Request bodyrequired

application/json also application/x-www-form-urlencoded, multipart/form-data

Body schema

object SchemaColumnCompatibility

  • idinteger
  • namestringrequired

    Max length 200

  • usagestring
  • typestringrequired
  • lengthintegernullable

    Min -2147483648 · Max 2147483647

  • measureone of
    Attributes

    • MeasureEnum

    • BlankEnum

    • NullEnum

  • descriptionstringnullable

    Max length 1000

Responses

201Createdapplication/json

Response schema

object SchemaColumnCompatibility

  • idinteger
  • namestringrequired

    Max length 200

  • usagestring
  • mappingsstring · urirequiredread-only
  • typestringrequired
  • lengthintegernullable

    Min -2147483648 · Max 2147483647

  • measureone of
    Attributes

    • MeasureEnum

    • BlankEnum

    • NullEnum

  • descriptionstringnullable

    Max length 1000

  • urlstring · urirequiredread-only

Get target columns

GET/api/target-columns/{id}/

API key permissionDestination: Read-onlydestination:read

Path parameters

  • idintegerrequired

    A unique integer value identifying this Target Field.

Responses

200OKapplication/json

Response schema

object SchemaColumnCompatibility

  • idinteger
  • namestringrequired

    Max length 200

  • usagestring
  • mappingsstring · urirequiredread-only
  • typestringrequired
  • lengthintegernullable

    Min -2147483648 · Max 2147483647

  • measureone of
    Attributes

    • MeasureEnum

    • BlankEnum

    • NullEnum

  • descriptionstringnullable

    Max length 1000

  • urlstring · urirequiredread-only

Replace target columns

PUT/api/target-columns/{id}/

API key permissionDestination: Writedestination:write

Path parameters

  • idintegerrequired

    A unique integer value identifying this Target Field.

Request bodyrequired

application/json also application/x-www-form-urlencoded, multipart/form-data

Body schema

object SchemaColumnCompatibility

  • idinteger
  • namestringrequired

    Max length 200

  • usagestring
  • typestringrequired
  • lengthintegernullable

    Min -2147483648 · Max 2147483647

  • measureone of
    Attributes

    • MeasureEnum

    • BlankEnum

    • NullEnum

  • descriptionstringnullable

    Max length 1000

Responses

200OKapplication/json

Response schema

object SchemaColumnCompatibility

  • idinteger
  • namestringrequired

    Max length 200

  • usagestring
  • mappingsstring · urirequiredread-only
  • typestringrequired
  • lengthintegernullable

    Min -2147483648 · Max 2147483647

  • measureone of
    Attributes

    • MeasureEnum

    • BlankEnum

    • NullEnum

  • descriptionstringnullable

    Max length 1000

  • urlstring · urirequiredread-only

Update target columns

PATCH/api/target-columns/{id}/

API key permissionDestination: Writedestination:write

Path parameters

  • idintegerrequired

    A unique integer value identifying this Target Field.

Request body

application/json also application/x-www-form-urlencoded, multipart/form-data

Body schema

object PatchedSchemaColumnCompatibility

  • idinteger
  • namestring

    Max length 200

  • usagestring
  • typestring
  • lengthintegernullable

    Min -2147483648 · Max 2147483647

  • measureone of
    Attributes

    • MeasureEnum

    • BlankEnum

    • NullEnum

  • descriptionstringnullable

    Max length 1000

Responses

200OKapplication/json

Response schema

object SchemaColumnCompatibility

  • idinteger
  • namestringrequired

    Max length 200

  • usagestring
  • mappingsstring · urirequiredread-only
  • typestringrequired
  • lengthintegernullable

    Min -2147483648 · Max 2147483647

  • measureone of
    Attributes

    • MeasureEnum

    • BlankEnum

    • NullEnum

  • descriptionstringnullable

    Max length 1000

  • urlstring · urirequiredread-only

Delete target columns

DELETE/api/target-columns/{id}/

API key permissionDestination: Writedestination:write

Path parameters

  • idintegerrequired

    A unique integer value identifying this Target Field.

Responses

204No response body

List target columns mappings

GET/api/target-columns/{parent_lookup_schema_column_id}/mappings/

API key permissionDestination: Read-onlydestination:read

Path parameters

  • parent_lookup_schema_column_idstringrequired

Query parameters

  • is_key_columnboolean
  • orderingstring

    Which field to use when ordering the results.

  • pageinteger

    A page number within the paginated result set.

  • source_column_namestring
  • source_content_typeinteger

Responses

200OKapplication/json

Response schema

object PaginatedDefaultSchemaMappingList

  • countintegerrequired

    Example 123

  • nextstring · urinullable

    Example "http://api.example.org/accounts/?page=4"

  • previousstring · urinullable

    Example "http://api.example.org/accounts/?page=2"

  • resultsarray of objectrequired
    Items · DefaultSchemaMapping
    • idintegerrequiredread-only
    • source_column_namestringrequired

      Max length 200

    • source_content_typeintegerrequired
    • target_columnobjectrequiredread-only
      Attributes · SchemaColumnCompatibility
      • idinteger
      • namestringrequired

        Max length 200

      • usagestring
      • mappingsstring · urirequiredread-only
      • typestringrequired
      • lengthintegernullable

        Min -2147483648 · Max 2147483647

      • measureone of
        Attributes

        • MeasureEnum

        • BlankEnum

        • NullEnum

      • descriptionstringnullable

        Max length 1000

      • urlstring · urirequiredread-only
    • is_key_columnboolean

Create target columns mappings

POST/api/target-columns/{parent_lookup_schema_column_id}/mappings/

API key permissionDestination: Writedestination:write

Path parameters

  • parent_lookup_schema_column_idstringrequired

Request bodyrequired

application/json also application/x-www-form-urlencoded, multipart/form-data

Body schema

object DefaultSchemaMapping

  • source_column_namestringrequired

    Max length 200

  • source_content_typeintegerrequired
  • target_column_idintegerrequiredwrite-only
  • is_key_columnboolean

Responses

201Createdapplication/json

Response schema

object DefaultSchemaMapping

  • idintegerrequiredread-only
  • source_column_namestringrequired

    Max length 200

  • source_content_typeintegerrequired
  • target_columnobjectrequiredread-only
    Attributes · SchemaColumnCompatibility
    • idinteger
    • namestringrequired

      Max length 200

    • usagestring
    • mappingsstring · urirequiredread-only
    • typestringrequired
    • lengthintegernullable

      Min -2147483648 · Max 2147483647

    • measureone of
      Attributes

      • MeasureEnum

      • BlankEnum

      • NullEnum

    • descriptionstringnullable

      Max length 1000

    • urlstring · urirequiredread-only
  • is_key_columnboolean

400The request body failed validation. Beyond the usual missing or malformed fields, this covers a target column id that does not resolve, and a source field or target column that is already mapped for this source type. On create it also covers a target column id that disagrees with the target column in the URL; an update may still move a mapping to another column.

409The mapping was not written. Usually a concurrent write claimed this source field or target column between validation and the write; a referenced target column or source type deleted in the same window is reported the same way. Re-read the mappings for this source type before retrying.application/json

Response schema

object DuplicateDefaultSchemaMapping

  • detailstringrequired

Get target columns mappings

GET/api/target-columns/{parent_lookup_schema_column_id}/mappings/{id}/

API key permissionDestination: Read-onlydestination:read

Path parameters

  • idintegerrequired

    A unique integer value identifying this Default Data Mapping.

  • parent_lookup_schema_column_idstringrequired

Responses

200OKapplication/json

Response schema

object DefaultSchemaMapping

  • idintegerrequiredread-only
  • source_column_namestringrequired

    Max length 200

  • source_content_typeintegerrequired
  • target_columnobjectrequiredread-only
    Attributes · SchemaColumnCompatibility
    • idinteger
    • namestringrequired

      Max length 200

    • usagestring
    • mappingsstring · urirequiredread-only
    • typestringrequired
    • lengthintegernullable

      Min -2147483648 · Max 2147483647

    • measureone of
      Attributes

      • MeasureEnum

      • BlankEnum

      • NullEnum

    • descriptionstringnullable

      Max length 1000

    • urlstring · urirequiredread-only
  • is_key_columnboolean

Replace target columns mappings

PUT/api/target-columns/{parent_lookup_schema_column_id}/mappings/{id}/

API key permissionDestination: Writedestination:write

Path parameters

  • idintegerrequired

    A unique integer value identifying this Default Data Mapping.

  • parent_lookup_schema_column_idstringrequired

Request bodyrequired

application/json also application/x-www-form-urlencoded, multipart/form-data

Body schema

object DefaultSchemaMapping

  • source_column_namestringrequired

    Max length 200

  • source_content_typeintegerrequired
  • target_column_idintegerrequiredwrite-only
  • is_key_columnboolean

Responses

200OKapplication/json

Response schema

object DefaultSchemaMapping

  • idintegerrequiredread-only
  • source_column_namestringrequired

    Max length 200

  • source_content_typeintegerrequired
  • target_columnobjectrequiredread-only
    Attributes · SchemaColumnCompatibility
    • idinteger
    • namestringrequired

      Max length 200

    • usagestring
    • mappingsstring · urirequiredread-only
    • typestringrequired
    • lengthintegernullable

      Min -2147483648 · Max 2147483647

    • measureone of
      Attributes

      • MeasureEnum

      • BlankEnum

      • NullEnum

    • descriptionstringnullable

      Max length 1000

    • urlstring · urirequiredread-only
  • is_key_columnboolean

400The request body failed validation. Beyond the usual missing or malformed fields, this covers a target column id that does not resolve, and a source field or target column that is already mapped for this source type.

409The mapping was not written. Usually a concurrent write claimed this source field or target column between validation and the write; a referenced target column or source type deleted in the same window is reported the same way. Re-read the mappings for this source type before retrying.application/json

Response schema

object DuplicateDefaultSchemaMapping

  • detailstringrequired

Update target columns mappings

PATCH/api/target-columns/{parent_lookup_schema_column_id}/mappings/{id}/

API key permissionDestination: Writedestination:write

Path parameters

  • idintegerrequired

    A unique integer value identifying this Default Data Mapping.

  • parent_lookup_schema_column_idstringrequired

Request body

application/json also application/x-www-form-urlencoded, multipart/form-data

Body schema

object PatchedDefaultSchemaMapping

  • source_column_namestring

    Max length 200

  • source_content_typeinteger
  • target_column_idintegerwrite-only
  • is_key_columnboolean

Responses

200OKapplication/json

Response schema

object DefaultSchemaMapping

  • idintegerrequiredread-only
  • source_column_namestringrequired

    Max length 200

  • source_content_typeintegerrequired
  • target_columnobjectrequiredread-only
    Attributes · SchemaColumnCompatibility
    • idinteger
    • namestringrequired

      Max length 200

    • usagestring
    • mappingsstring · urirequiredread-only
    • typestringrequired
    • lengthintegernullable

      Min -2147483648 · Max 2147483647

    • measureone of
      Attributes

      • MeasureEnum

      • BlankEnum

      • NullEnum

    • descriptionstringnullable

      Max length 1000

    • urlstring · urirequiredread-only
  • is_key_columnboolean

400The request body failed validation. Beyond the usual missing or malformed fields, this covers a target column id that does not resolve, and a source field or target column that is already mapped for this source type.

409The mapping was not written. Usually a concurrent write claimed this source field or target column between validation and the write; a referenced target column or source type deleted in the same window is reported the same way. Re-read the mappings for this source type before retrying.application/json

Response schema

object DuplicateDefaultSchemaMapping

  • detailstringrequired

Delete target columns mappings

DELETE/api/target-columns/{parent_lookup_schema_column_id}/mappings/{id}/

API key permissionDestination: Writedestination:write

Path parameters

  • idintegerrequired

    A unique integer value identifying this Default Data Mapping.

  • parent_lookup_schema_column_idstringrequired

Responses

204No response body

List target types

GET/api/target-types/

API key permissionDestination: Read-onlydestination:read

Query parameters

  • pageinteger

    A page number within the paginated result set.

  • page_sizeinteger

    Number of results to return per page.

  • searchstring

    A search term.

Responses

200OKapplication/json

Response schema

object PaginatedBaseTargetTypeList

  • countintegerrequired

    Example 123

  • nextstring · urinullable

    Example "http://api.example.org/accounts/?page=4"

  • previousstring · urinullable

    Example "http://api.example.org/accounts/?page=2"

  • resultsarray of objectrequired
    Items · BaseTargetType
    • idintegerrequiredread-only
    • namestringrequiredread-only
    • slugstringrequiredread-only
    • canonical_namestringrequiredread-only
    • urlstring · urirequiredread-only
    • targetsstring · urirequiredread-only

Get target types

GET/api/target-types/{id}/

API key permissionDestination: Read-onlydestination:read

Path parameters

  • idintegerrequired

    A unique integer value identifying this content type.

Responses

200OKapplication/json

Response schema

object BaseTargetType

  • idintegerrequiredread-only
  • namestringrequiredread-only
  • slugstringrequiredread-only
  • canonical_namestringrequiredread-only
  • urlstring · urirequiredread-only
  • targetsstring · urirequiredread-only

Get target types targets (GET /api/target-types/{parent_lookup_type_id}/targets/)

GET/api/target-types/{parent_lookup_type_id}/targets/

API key permissionDestination: Read-onlydestination:read

Path parameters

  • parent_lookup_type_idstringrequired

Responses

200No response body

Create target types targets

POST/api/target-types/{parent_lookup_type_id}/targets/

API key permissionDestination: Writedestination:write

Path parameters

  • parent_lookup_type_idstringrequired

Responses

201No response body

Get target types targets (GET /api/target-types/{parent_lookup_type_id}/targets/{id}/)

GET/api/target-types/{parent_lookup_type_id}/targets/{id}/

API key permissionDestination: Read-onlydestination:read

Path parameters

  • idstringrequired
  • parent_lookup_type_idstringrequired

Responses

200No response body

Replace target types targets

PUT/api/target-types/{parent_lookup_type_id}/targets/{id}/

API key permissionDestination: Writedestination:write

Path parameters

  • idstringrequired
  • parent_lookup_type_idstringrequired

Responses

200No response body

Update target types targets

PATCH/api/target-types/{parent_lookup_type_id}/targets/{id}/

API key permissionDestination: Writedestination:write

Path parameters

  • idstringrequired
  • parent_lookup_type_idstringrequired

Responses

200No response body

Delete target types targets

DELETE/api/target-types/{parent_lookup_type_id}/targets/{id}/

API key permissionDestination: Writedestination:write

Path parameters

  • idstringrequired
  • parent_lookup_type_idstringrequired

Responses

204No response body

Get target types targets mappings (GET /api/target-types/{parent_lookup_type_id}/targets/{parent_lookup_target_id}/mappings/)

GET/api/target-types/{parent_lookup_type_id}/targets/{parent_lookup_target_id}/mappings/

API key permissionDestination: Read-onlydestination:read

Path parameters

  • parent_lookup_target_idstringrequired
  • parent_lookup_type_idstringrequired

Responses

200No response body

Create target types targets mappings

POST/api/target-types/{parent_lookup_type_id}/targets/{parent_lookup_target_id}/mappings/

API key permissionDestination: Writedestination:write

Path parameters

  • parent_lookup_target_idstringrequired
  • parent_lookup_type_idstringrequired

Responses

201No response body

Get target types targets mappings (GET /api/target-types/{parent_lookup_type_id}/targets/{parent_lookup_target_id}/mappings/{id}/)

GET/api/target-types/{parent_lookup_type_id}/targets/{parent_lookup_target_id}/mappings/{id}/

API key permissionDestination: Read-onlydestination:read

Path parameters

  • idstringrequired
  • parent_lookup_target_idstringrequired
  • parent_lookup_type_idstringrequired

Responses

200No response body

Replace target types targets mappings

PUT/api/target-types/{parent_lookup_type_id}/targets/{parent_lookup_target_id}/mappings/{id}/

API key permissionDestination: Writedestination:write

Path parameters

  • idstringrequired
  • parent_lookup_target_idstringrequired
  • parent_lookup_type_idstringrequired

Responses

200No response body

Update target types targets mappings

PATCH/api/target-types/{parent_lookup_type_id}/targets/{parent_lookup_target_id}/mappings/{id}/

API key permissionDestination: Writedestination:write

Path parameters

  • idstringrequired
  • parent_lookup_target_idstringrequired
  • parent_lookup_type_idstringrequired

Responses

200No response body

Delete target types targets mappings

DELETE/api/target-types/{parent_lookup_type_id}/targets/{parent_lookup_target_id}/mappings/{id}/

API key permissionDestination: Writedestination:write

Path parameters

  • idstringrequired
  • parent_lookup_target_idstringrequired
  • parent_lookup_type_idstringrequired

Responses

204No response body

Was this page helpful?