EpicDirectories

EpicDirectories Listing Attributes API

The listing-attributes API from EpicDirectories — 4 operation(s) for listing-attributes.

GitHub OpenAPI

Operations 6

GET /v1/directories/{directoryId}/listings/{listingId}/attributes Get all attribute values for a listing #
PUT /v1/directories/{directoryId}/listings/{listingId}/attributes Set attribute values for a listing (bulk upsert) #
DELETE /v1/directories/{directoryId}/listings/{listingId}/attributes/{templateId} Delete a specific attribute value #
POST /v1/directories/{directoryId}/listings/bulk/attributes Set attributes on multiple listings at once #
GET /v1/directories/{directoryId}/listings/{listingId}/terms Get taxonomy terms for a listing #
PUT /v1/directories/{directoryId}/listings/{listingId}/terms Set taxonomy terms for a listing (replaces existing) #

Specifications

⚙
OpenAPI
https://artifacts.apis.io/epicdirectories/openapi/epicdirectories-listing-attributes-api-openapi.yml

Schemas & Data

📊
JSONSchema
https://artifacts.apis.io/epicdirectories/json-schema/epicdirectories-bulk-set-attributes-dto-schema.json
📊
JSONSchema
https://artifacts.apis.io/epicdirectories/json-schema/epicdirectories-set-attributes-dto-schema.json

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/epicdirectories:epicdirectories-listing-attributes-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

epicdirectories-listing-attributes-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: EpicDirectories Listing Attributes API
  description: API-first directory data platform.
  version: '1.0'
  contact: {}
servers:
- url: https://api.epicdirectories.com
  description: Production
- url: http://localhost:3333
  description: Local development
tags:
- name: listing-attributes
paths:
  /v1/directories/{directoryId}/listings/{listingId}/attributes:
    get:
      operationId: ListingAttributesController_getAttributes
      summary: Get all attribute values for a listing
      parameters:
      - name: directoryId
        required: true
        in: path
        schema:
          type: string
      - name: listingId
        required: true
        in: path
        schema:
          type: string
      responses:
        '200':
          description: Attribute values keyed by template
        '404':
          description: Listing or directory not found
      tags:
      - listing-attributes
      security:
      - bearer: []
    put:
      operationId: ListingAttributesController_setAttributes
      summary: Set attribute values for a listing (bulk upsert)
      parameters:
      - name: directoryId
        required: true
        in: path
        schema:
          type: string
      - name: listingId
        required: true
        in: path
        schema:
          type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SetAttributesDto'
      responses:
        '200':
          description: Attributes upserted
        '400':
          description: Unknown attribute keys for this listing type
        '404':
          description: Listing or directory not found
      tags:
      - listing-attributes
      security:
      - bearer: []
  /v1/directories/{directoryId}/listings/{listingId}/attributes/{templateId}:
    delete:
      operationId: ListingAttributesController_deleteAttribute
      summary: Delete a specific attribute value
      parameters:
      - name: directoryId
        required: true
        in: path
        schema:
          type: string
      - name: listingId
        required: true
        in: path
        schema:
          type: string
      - name: templateId
        required: true
        in: path
        schema:
          type: string
      responses:
        '204':
          description: Attribute removed
        '404':
          description: Listing, attribute, or directory not found
      tags:
      - listing-attributes
      security:
      - bearer: []
  /v1/directories/{directoryId}/listings/bulk/attributes:
    post:
      operationId: ListingAttributesController_bulkSetAttributes
      summary: Set attributes on multiple listings at once
      parameters:
      - name: directoryId
        required: true
        in: path
        schema:
          type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/BulkSetAttributesDto'
      responses:
        '201':
          description: Bulk upsert applied; per-listing results returned
        '400':
          description: Unknown attribute keys
        '404':
          description: Directory not found
      tags:
      - listing-attributes
      security:
      - bearer: []
  /v1/directories/{directoryId}/listings/{listingId}/terms:
    get:
      operationId: ListingAttributesController_getTerms
      summary: Get taxonomy terms for a listing
      parameters:
      - name: directoryId
        required: true
        in: path
        schema:
          type: string
      - name: listingId
        required: true
        in: path
        schema:
          type: string
      responses:
        '200':
          description: Assigned terms grouped by taxonomy
        '404':
          description: Listing or directory not found
      tags:
      - listing-attributes
      security:
      - bearer: []
    put:
      operationId: ListingAttributesController_setTerms
      summary: Set taxonomy terms for a listing (replaces existing)
      parameters:
      - name: directoryId
        required: true
        in: path
        schema:
          type: string
      - name: listingId
        required: true
        in: path
        schema:
          type: string
      responses:
        '200':
          description: Term assignments replaced
        '400':
          description: Unknown term IDs
        '404':
          description: Listing or directory not found
      tags:
      - listing-attributes
      security:
      - bearer: []
components:
  schemas:
    SetAttributesDto:
      type: object
      properties:
        attributes:
          description: Array of attribute values to set
          type: array
          items:
            $ref: '#/components/schemas/AttributeValueDto'
      required:
      - attributes
    BulkSetAttributesDto:
      type: object
      properties:
        listingIds:
          description: Listing IDs to update
          type: array
          items:
            type: string
        attributes:
          description: Array of attribute values to set on all listings
          type: array
          items:
            $ref: '#/components/schemas/AttributeValueDto'
      required:
      - listingIds
      - attributes
    AttributeValueDto:
      type: object
      properties:
        attributeTemplateId:
          type: string
          description: Attribute template ID
        value:
          type: object
          description: Value (type depends on attribute template)
      required:
      - attributeTemplateId
      - value
  securitySchemes:
    bearer:
      scheme: bearer
      bearerFormat: JWT
      type: http
    apiKey:
      type: apiKey
      in: header
      name: x-api-key
x-provenance:
  method: harvested
  publisher: EpicDirectories
  source: https://api.epicdirectories.com/openapi.json
  note: split by refine-openapis from the provider's own published document, verified by fetch (openapi/_original/*.fetch.json);
    stamped by stamp-openapi-provenance.py (roadmap#793)