resources/beta/subresources/threads/methods/delete/index.md 2026-08-26 22:57 UTC to 2026-08-27 21:01 UTC

1## Delete thread

2 

3**delete** `/threads/{thread_id}`

4 

5Delete a thread.

6 

7### Path Parameters

8 

9- `thread_id: string`

10 

11### Returns

12 

13- `ThreadDeleted object { id, deleted, object }`

14 

15 - `id: string`

16 

17 - `deleted: boolean`

18 

19 - `object: "thread.deleted"`

20 

21 - `"thread.deleted"`

22 

23### Example

24 

25```http

26curl https://api.openai.com/v1/threads/$THREAD_ID \

27 -X DELETE \

28 -H 'OpenAI-Beta: assistants=v2' \

29 -H "Authorization: Bearer $OPENAI_API_KEY"

30```

31 

32#### Response

33 

34```json

35{

36 "id": "id",

37 "deleted": true,

38 "object": "thread.deleted"

39}

40```

41 

42### Example

43 

44```http

45curl https://api.openai.com/v1/threads/thread_abc123 \

46 -H "Content-Type: application/json" \

47 -H "Authorization: Bearer $OPENAI_API_KEY" \

48 -H "OpenAI-Beta: assistants=v2" \

49 -X DELETE

50```

51 

52#### Response

53 

54```json

55{

56 "id": "thread_abc123",

57 "object": "thread.deleted",

58 "deleted": true

59}

60```