Creates a copy of an existing filter.

POST

https://api.awork.com/api/v1/me/filters/:filterId/copy

POST

/api/v1/me/filters/:filterId/copy

$ curl -X POST https://api.awork.com/api/v1/me/filters/filterId/copy \
>      -H "Authorization: Bearer <token>" \
>      -H "Content-Type: application/json" \
>      -d '{}'

1 {
2   "id": "9f8b7c6d-1234-4a56-b789-0cdef1234567",
3   "createdOn": "2024-04-20T10:15:30.000Z",
4   "createdBy": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
5   "updatedOn": "2024-04-21T14:45:00.000Z",
6   "updatedBy": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
7   "name": "Active Tasks (Copy)",
8   "filterDefinition": {
9     "conditionGroups": [
10       {
11         "conditions": [
12           {
13             "field": "status",
14             "type": "Comparison",
15             "operator": "Equal",
16             "values": [
17               {
18                 "constantValue": "Active",
19                 "filterValueKind": "Constant",
20                 "computedValueKind": null,
21                 "daysOffset": null
22               }
23             ],
24             "customFieldInformation": {
25               "customFieldDefinitionId": "d4e5f6a7-b890-1234-cdef-56789abcdef0",
26               "customFieldValueType": "Text"
27             }
28           }
29         ],
30         "connector": "And"
31       }
32     ],
33     "rootConnector": "And",
34     "entityType": "tasks"
35   },
36   "isExternal": false,
37   "entityType": "tasks",
38   "userId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
39   "filterQuery": "status eq 'Active'",
40   "workspaceAccessLevel": "read",
41   "contributors": [
42     {
43       "id": "b2c3d4e5-f678-9012-abcd-ef3456789012",
44       "userId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
45       "accessLevel": "read",
46       "firstName": "Lisa",
47       "lastName": "Smith",
48       "hasImage": true,
49       "isDeactivated": false
50     }
51   ],
52   "teams": [
53     {
54       "id": "c3d4e5f6-7890-1234-abcd-ef4567890123",
55       "teamId": "d4e5f6a7-8901-2345-bcde-f56789012345",
56       "accessLevel": "read",
57       "name": "Designers",
58       "icon": "paintbrush",
59       "color": "purple"
60     }
61   ]
62 }

Copies the filter definition and query. The copied filter will be owned only by the requesting user. The name of the copied filter will be “{original name} (Copy)” or “{original name} (Kopie)” for German users.

Required Permissions

Any authenticated user.

Copies the filter definition and query. The copied filter will be owned only by the requesting user. The name of the copied filter will be "{original name} (Copy)" or "{original name} (Kopie)" for German users. <Check title="Required Permissions" icon="key">Any authenticated user.</Check>

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

filterIdstringRequiredformat: "uuid"

The identifier of the filter to copy.

Response

idstringOptionalformat: "uuid"

The id of the entity.

createdOnstringOptionalformat: "date-time"

The date this entity was created.

createdBystringOptionalformat: "uuid"

The id of the user who created this entity.

updatedOnstringOptionalformat: "date-time"

The date this entity was last modified.

updatedBystringOptionalformat: "uuid"

The id of the user who last modified this entity.

namestring or nullOptional

The name of the filter.

filterDefinitionobjectOptional

The structured filter representation of a filter query.

isExternalbooleanOptional

Whether this filter is coming from an external workspace (awork Connect).

entityTypestring or nullOptional

The entity type this filter targets. Can be 'projects', 'tasks', 'companies', 'users'.

userIdstringOptionalformat: "uuid"

The id of the user this filter was created for.

filterQuerystring or nullOptional

The OData- query string that will be applied for querying this filter’s underlying data type.

workspaceAccessLevelstring or nullOptional

Determines the level of access to this filter granted to all workspace users. Can be either not set (no access), read, or manage.

contributorslist of objects or nullOptional

The users explicitly connected to this filter.

teamslist of objects or nullOptional

The teams explicitly connected to this filter.

Errors

400

Bad Request Error

401

Unauthorized Error

404

Not Found Error