--- updatedAt: 2026-04-20T20:26:21.000Z agentTools: projectIndex: https://docs.wistia.com/llms.txt --- # Bulk Tag Media This method accepts a list of medias to tag. It processes requests asynchronously and will return a background_job_status object rather than the typical Media response object. The tags will be added to the existing tags on each media file, not replaced. ## Requires api token with one of the following permissions ``` Read, update & delete anything ``` Tokens with the "Act with a team member's permissions" permission (`all:delegate_to_contact_permissions` scope) can also be used. Requests made with such a token are authorized using the permissions of the contact assigned to the token. Expiring access tokens created with authorizations cannot be used; such requests fail with a 403. # OpenAPI definition ````json { "openapi": "3.1.1", "info": { "title": "Data API", "description": "Wistia Data API", "version": "2026.09.0" }, "servers": [ { "url": "https://api.wistia.com/modern" } ], "security": [ { "BearerAuth": [] } ], "tags": [ { "name": "Taggings" } ], "paths": { "/taggings/bulk_create": { "post": { "summary": "Bulk Tag Media", "x-speakeasy-group": "taggings", "x-speakeasy-name-override": "bulkCreate", "x-cli-action-override": "bulk-tag", "description": "This method accepts a list of medias to tag. It processes requests asynchronously and will return a background_job_status object rather than the typical Media response object.\n\nThe tags will be added to the existing tags on each media file, not replaced.\n\n## Requires api token with one of the following permissions\n```\nRead, update & delete anything\n```\n\nTokens with the \"Act with a team member's permissions\" permission\n(`all:delegate_to_contact_permissions` scope) can also be used. Requests\nmade with such a token are authorized using the permissions of the\ncontact assigned to the token.\n\nExpiring access tokens created with authorizations cannot be used; such\nrequests fail with a 403.\n", "requestBody": { "required": true, "content": { "application/json": { "schema": { "unevaluatedProperties": false, "type": "object", "properties": { "hashed_ids": { "description": "An array of the media hashed IDs to be tagged.", "type": "array", "items": { "type": "string" } }, "tag_names": { "description": "An array of tag names to add to each media.", "type": "array", "items": { "type": "string" } } }, "required": [ "hashed_ids", "tag_names" ] } } } }, "responses": { "200": { "description": "Successful tagging of media.", "content": { "application/json": { "schema": { "unevaluatedProperties": false, "allOf": [ { "type": "object", "properties": { "message": { "description": "A confirmation message that the background job has been queued.", "type": "string" }, "background_job_status": { "unevaluatedProperties": false, "allOf": [ { "type": "object", "description": "A background job keeps track of the progress of an asynchronous task, e.g\nbulk archiving media, translating media, etc.\n", "properties": { "id": { "description": "The ID of the background job that's been queued for the request.", "type": "integer" }, "hashed_id": { "description": "The unguessable hashed ID of the background job. Prefer this over the numeric ID when polling for status.", "type": "string" }, "status": { "description": "The status of the background job that's been queued for the request.", "type": "string", "enum": [ "queued", "started", "finished", "failed" ] } }, "required": [ "id", "hashed_id", "status" ] } ] } }, "required": [ "message", "background_job_status" ] } ] } } } }, "401": { "description": "Unauthorized, invalid or missing token", "content": { "application/json": { "schema": { "unevaluatedProperties": false, "type": "object", "properties": { "code": { "description": "A machine-readable identifier for the specific authorization failure.", "type": "string", "enum": [ "unauthorized_credentials", "account_inactive", "unauthorized_scope", "unauthorized_params" ] }, "error": { "type": "string", "examples": [ "Invalid credentials." ] } } } } } }, "403": { "description": "Forbidden, token is valid but account does not have access to feature", "content": { "application/json": { "schema": { "unevaluatedProperties": false, "type": "object", "properties": { "error": { "type": "string", "examples": [ "Webinars are not available on your current plan" ] } } } } } }, "422": { "description": "Unprocessable entity, e.g. missing required parameters.", "content": { "application/json": { "schema": { "unevaluatedProperties": false, "type": "object", "properties": { "error": { "type": "string" } } } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "unevaluatedProperties": false, "type": "object", "properties": { "error": { "type": "string", "examples": [ "Internal server error" ] } } } } } } }, "tags": [ "Taggings" ], "parameters": [ { "name": "X-Wistia-API-Version", "in": "header", "required": true, "schema": { "type": "string", "default": "2026-09" } } ], "x-readme": { "code-samples": [ { "name": "Typescript (SDK)", "language": "javascript", "code": "import { Wistia } from \"@wistia/wistia-api-client\";\n\nconst wistia = new Wistia({\n bearerAuth: process.env[\"WISTIA_BEARER_AUTH\"] ?? \"\",\n});\n\nasync function run() {\n const result = await wistia.taggings.bulkCreate({\n hashedIds: [\n \"\",\n \"\",\n \"\",\n ],\n tagNames: [\n \"\",\n ],\n });\n\n console.log(result);\n}\n\nrun();" } ] } } } }, "components": { "securitySchemes": { "BearerAuth": { "type": "http", "scheme": "bearer" } } }, "x-readme": { "samples-languages": [ "javascript", "shell", "node", "python", "ruby" ] } } ````