> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pinkfish.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# sap-concur-list

> SAP Concur Lists

**Server path:** `/sap-concur-list` | **Type:** Application | **PCID required:** Yes

## Tools

| Tool                                                                                                    | Description               |
| ------------------------------------------------------------------------------------------------------- | ------------------------- |
| [`sap_concur_list_create_list_using_post`](#sap_concur_list_create_list_using_post)                     | Create a new list         |
| [`sap_concur_list_delete_using_delete`](#sap_concur_list_delete_using_delete)                           | Remove a list             |
| [`sap_concur_list_get_all_lists_using_get`](#sap_concur_list_get_all_lists_using_get)                   | Get all lists             |
| [`sap_concur_list_get_lists_for_category_using_get`](#sap_concur_list_get_lists_for_category_using_get) | Get a list by category ID |
| [`sap_concur_list_get_using_get`](#sap_concur_list_get_using_get)                                       | Get a list by list ID     |
| [`sap_concur_list_put_using_put`](#sap_concur_list_put_using_put)                                       | Update a list             |

***

## sap\_concur\_list\_create\_list\_using\_post

Create a new list

**Parameters:**

| Parameter         | Type    | Required | Default | Description                                                                                                |
| ----------------- | ------- | -------- | ------- | ---------------------------------------------------------------------------------------------------------- |
| `Accept-Language` | string  | No       | —       | Language code                                                                                              |
| `categoryId`      | string  | No       | —       | The unique identifier of the category that the list belongs to                                             |
| `displayFormat`   | string  | No       | —       | Whether we display code or value first                                                                     |
| `isManaged`       | boolean | No       | —       | Boolean indicating if the list is managed and list modifications can be made from this partner app id only |
| `searchCriteria`  | string  | No       | —       | What attribute to search by                                                                                |
| `value`           | string  | Yes      | —       | Name of the list                                                                                           |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "Accept-Language": {
        "type": "string",
        "description": "Language code"
      },
      "categoryId": {
        "type": "string",
        "description": "The unique identifier of the category that the list belongs to"
      },
      "displayFormat": {
        "type": "string",
        "description": "Whether we display code or value first",
        "enum": [
          "(CODE) TEXT",
          "TEXT (CODE)"
        ]
      },
      "isManaged": {
        "type": "boolean",
        "description": "Boolean indicating if the list is managed and list modifications can be made from this partner app id only"
      },
      "searchCriteria": {
        "type": "string",
        "description": "What attribute to search by",
        "enum": [
          "TEXT",
          "CODE"
        ]
      },
      "value": {
        "type": "string",
        "description": "Name of the list"
      }
    },
    "required": [
      "PCID",
      "value"
    ]
  }
  ```
</Expandable>

***

## sap\_concur\_list\_delete\_using\_delete

Remove a list

**Parameters:**

| Parameter | Type   | Required | Default | Description                       |
| --------- | ------ | -------- | ------- | --------------------------------- |
| `listId`  | string | Yes      | —       | The unique identifier of the list |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "listId": {
        "type": "string",
        "description": "The unique identifier of the list"
      }
    },
    "required": [
      "PCID",
      "listId"
    ]
  }
  ```
</Expandable>

***

## sap\_concur\_list\_get\_all\_lists\_using\_get

Get all lists

**Parameters:**

| Parameter         | Type    | Required | Default | Description                                                                                                                                                     |
| ----------------- | ------- | -------- | ------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `Accept-Language` | string  | No       | —       | Language code                                                                                                                                                   |
| `category.type`   | string  | No       | —       | Filter capabilities for Category Type. Supports the equals and not equals operators.                                                                            |
| `isDeleted`       | boolean | No       | —       | Filter capabilities to show deleted lists. Supports the equals operator.                                                                                        |
| `levelCount`      | string  | No       | —       | Filter capabilities for Level Count. Supports the equals, less than, less than or equal to, greater than, greater than or equal to operators.                   |
| `sortBy`          | string  | No       | —       | Field to sort by, \{name, levelcount, listcategory}                                                                                                             |
| `sortDirection`   | string  | No       | —       | Sort direction, \{asc, desc}                                                                                                                                    |
| `page`            | integer | No       | —       | Page number starting from 1                                                                                                                                     |
| `value`           | string  | No       | —       | Filter capabilities for Value. Supports the following operators: equals, starts with, ends with, not equals, and contains pattern. Filtering is case-sensitive. |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "Accept-Language": {
        "type": "string",
        "description": "Language code"
      },
      "category.type": {
        "type": "string",
        "description": "Filter capabilities for Category Type. Supports the equals and not equals operators."
      },
      "isDeleted": {
        "type": "boolean",
        "description": "Filter capabilities to show deleted lists. Supports the equals operator."
      },
      "levelCount": {
        "type": "string",
        "description": "Filter capabilities for Level Count. Supports the equals, less than, less than or equal to, greater than, greater than or equal to operators."
      },
      "sortBy": {
        "type": "string",
        "description": "Field to sort by, {name, levelcount, listcategory}",
        "enum": [
          "name",
          "levelcount",
          "listcategory"
        ]
      },
      "sortDirection": {
        "type": "string",
        "description": "Sort direction, {asc, desc}",
        "enum": [
          "asc",
          "desc"
        ]
      },
      "page": {
        "type": "integer",
        "description": "Page number starting from 1"
      },
      "value": {
        "type": "string",
        "description": "Filter capabilities for Value. Supports the following operators: equals, starts with, ends with, not equals, and contains pattern. Filtering is case-sensitive."
      }
    },
    "required": [
      "PCID"
    ]
  }
  ```
</Expandable>

***

## sap\_concur\_list\_get\_lists\_for\_category\_using\_get

Get a list by category ID

**Parameters:**

| Parameter         | Type    | Required | Default | Description                           |
| ----------------- | ------- | -------- | ------- | ------------------------------------- |
| `Accept-Language` | string  | No       | —       | Language code                         |
| `categoryId`      | string  | Yes      | —       | The unique identifier of the category |
| `page`            | integer | No       | —       | Page number starting from 1           |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "Accept-Language": {
        "type": "string",
        "description": "Language code"
      },
      "categoryId": {
        "type": "string",
        "description": "The unique identifier of the category"
      },
      "page": {
        "type": "integer",
        "description": "Page number starting from 1"
      }
    },
    "required": [
      "PCID",
      "categoryId"
    ]
  }
  ```
</Expandable>

***

## sap\_concur\_list\_get\_using\_get

Get a list by list ID

**Parameters:**

| Parameter         | Type   | Required | Default | Description                       |
| ----------------- | ------ | -------- | ------- | --------------------------------- |
| `Accept-Language` | string | No       | —       | Language code                     |
| `listId`          | string | Yes      | —       | The unique identifier of the list |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "Accept-Language": {
        "type": "string",
        "description": "Language code"
      },
      "listId": {
        "type": "string",
        "description": "The unique identifier of the list"
      }
    },
    "required": [
      "PCID",
      "listId"
    ]
  }
  ```
</Expandable>

***

## sap\_concur\_list\_put\_using\_put

Update a list

**Parameters:**

| Parameter         | Type    | Required | Default | Description                                                                                                |
| ----------------- | ------- | -------- | ------- | ---------------------------------------------------------------------------------------------------------- |
| `Accept-Language` | string  | No       | —       | Language code                                                                                              |
| `listId`          | string  | Yes      | —       | The unique identifier of the list                                                                          |
| `displayFormat`   | string  | No       | —       | Whether we display code or value first                                                                     |
| `isManaged`       | boolean | No       | —       | Boolean indicating if the list is managed and list modifications can be made from this partner app id only |
| `searchCriteria`  | string  | No       | —       | What attribute to search by                                                                                |
| `value`           | string  | Yes      | —       | Name of the list                                                                                           |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "Accept-Language": {
        "type": "string",
        "description": "Language code"
      },
      "listId": {
        "type": "string",
        "description": "The unique identifier of the list"
      },
      "displayFormat": {
        "type": "string",
        "description": "Whether we display code or value first",
        "enum": [
          "(CODE) TEXT",
          "TEXT (CODE)"
        ]
      },
      "isManaged": {
        "type": "boolean",
        "description": "Boolean indicating if the list is managed and list modifications can be made from this partner app id only"
      },
      "searchCriteria": {
        "type": "string",
        "description": "What attribute to search by",
        "enum": [
          "TEXT",
          "CODE"
        ]
      },
      "value": {
        "type": "string",
        "description": "Name of the list"
      }
    },
    "required": [
      "PCID",
      "listId",
      "value"
    ]
  }
  ```
</Expandable>