> ## Documentation Index > Fetch the complete documentation index at: https://docs.member.dev/llms.txt > Use this file to discover all available pages before exploring further. # List File Usages > List persisted direct holders of a visible team library file. Contact actors are scoped to their active, owned hubs. This endpoint intentionally reports persisted relationships only; JSON page-builder documents and transitive ancestry are not indexed here. ## OpenAPI ````yaml /openapi/mio-openapi.json get /api/v1/teams/{team_id}/files/{id}/usages openapi: 3.1.0 info: description: >- Production API reference for Membership.io. Use the authored guides for workflows and the generated endpoint pages for exact parameters and schemas. title: Membership.io API version: 0.1.0 servers: - description: Production url: https://api.member.dev security: - bearerAuth: [] paths: /api/v1/teams/{team_id}/files/{id}/usages: get: tags: - media-admin summary: List File Usages description: |- List persisted direct holders of a visible team library file. Contact actors are scoped to their active, owned hubs. This endpoint intentionally reports persisted relationships only; JSON page-builder documents and transitive ancestry are not indexed here. operationId: media_admin.get_media_admin_get_teams_by_team_id_files_by_id_usages parameters: - in: path name: team_id required: true schema: title: Team Id type: string - in: path name: id required: true schema: title: Id type: string - in: query name: include_deleted required: false schema: default: false title: Include Deleted type: boolean - description: Cursor — ID of the last item on the previous page. in: query name: page[after] required: false schema: anyOf: - type: string - type: 'null' description: Cursor — ID of the last item on the previous page. title: Page[After] - in: query name: page[size] required: false schema: default: 20 maximum: 100 minimum: 1 title: Page[Size] type: integer responses: '200': content: application/vnd.api+json: schema: $ref: '#/components/schemas/JsonApiListResponse_FileUsageAttributes_' description: Successful Response '422': content: application/vnd.api+json: schema: $ref: '#/components/schemas/HTTPValidationError' description: Validation Error security: - HTTPBearer: [] components: schemas: JsonApiListResponse_FileUsageAttributes_: properties: data: items: $ref: '#/components/schemas/JsonApiResource_FileUsageAttributes_' title: Data type: array included: anyOf: - items: {} type: array - type: 'null' title: Included links: anyOf: - $ref: '#/components/schemas/JsonApiPaginationLinks' - type: 'null' meta: anyOf: - additionalProperties: true type: object - type: 'null' title: Meta required: - data title: JsonApiListResponse[FileUsageAttributes] type: object HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' title: Detail type: array title: HTTPValidationError type: object JsonApiResource_FileUsageAttributes_: properties: attributes: $ref: '#/components/schemas/FileUsageAttributes' id: title: Id type: string links: anyOf: - $ref: '#/components/schemas/JsonApiLinks' - type: 'null' meta: anyOf: - additionalProperties: true type: object - type: 'null' title: Meta relationships: anyOf: - additionalProperties: true type: object - type: 'null' title: Relationships type: title: Type type: string required: - id - type - attributes title: JsonApiResource[FileUsageAttributes] type: object JsonApiPaginationLinks: properties: next: anyOf: - type: string - type: 'null' title: Next self: anyOf: - type: string - type: 'null' title: Self title: JsonApiPaginationLinks type: object ValidationError: properties: ctx: title: Context type: object input: title: Input loc: items: anyOf: - type: string - type: integer title: Location type: array msg: title: Message type: string type: title: Error Type type: string required: - loc - msg - type title: ValidationError type: object FileUsageAttributes: additionalProperties: false description: A unique holder of a file and its bounded list of stored references. properties: deleted: default: false title: Deleted type: boolean deleted_at: anyOf: - format: date-time type: string - type: 'null' title: Deleted At hub_deleted: default: false title: Hub Deleted type: boolean hub_id: anyOf: - type: string - type: 'null' title: Hub Id hub_title: anyOf: - type: string - type: 'null' title: Hub Title reference_count: title: Reference Count type: integer references: items: $ref: '#/components/schemas/FileUsageReferenceAttributes' title: References type: array references_truncated: title: References Truncated type: boolean title: title: Title type: string usage_id: title: Usage Id type: string usage_type: enum: - hub - playlist - content_node - page title: Usage Type type: string required: - usage_type - usage_id - title - references - reference_count - references_truncated title: FileUsageAttributes type: object JsonApiLinks: properties: self: anyOf: - type: string - type: 'null' title: Self title: JsonApiLinks type: object FileUsageReferenceAttributes: additionalProperties: false description: One persisted route from a holder back to the file. properties: deleted: default: false title: Deleted type: boolean hub_id: anyOf: - type: string - type: 'null' title: Hub Id hub_title: anyOf: - type: string - type: 'null' title: Hub Title id: title: Id type: string kind: enum: - hub_branding - hub_media_file - hub_media_playlist - playlist_attachment - playlist_item - content_node_attachment - content_node_media - page_section_attachment title: Kind type: string publication_state: anyOf: - enum: - draft - scheduled - published type: string - type: 'null' title: Publication State published_at: anyOf: - format: date-time type: string - type: 'null' title: Published At role: anyOf: - type: string - type: 'null' title: Role section_id: anyOf: - type: string - type: 'null' title: Section Id required: - kind - id title: FileUsageReferenceAttributes type: object securitySchemes: bearerAuth: bearerFormat: JWT or mio_sk API key description: >- Send platform JWTs, contact JWTs, or team API keys as `Authorization: Bearer `. scheme: bearer type: http HTTPBearer: scheme: bearer type: http ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.