API reference

    Base URL https://api.mecore.ai/api/v1/org. Every request needs Authorization: Bearer <your API key>.

    Download openapi.json
    get
    /me

    Verify an API key

    Cheap ping to confirm a key is valid.

    Responses

    • 200 — Valid key
    • 401 — Missing, invalid or revoked key
    • 429 — Rate limited
    curl -X GET "https://api.mecore.ai/api/v1/org/me" \
  -H "Authorization: Bearer $MECORE_API_KEY" \
  -H "Content-Type: application/json"
    get
    /cores

    List cores

    Parameters

    • page (query)
    • limit (query)
    • query (query) — Synonym-aware search over name, tags and style attributes

    Responses

    • 200 — Paginated cores
    • 401 — Missing, invalid or revoked key
    • 429 — Rate limited
    curl -X GET "https://api.mecore.ai/api/v1/org/cores" \
  -H "Authorization: Bearer $MECORE_API_KEY" \
  -H "Content-Type: application/json"
    post
    /cores

    Create a core

    Images are ingested synchronously; the taste profile generates in the background. Returns 202 with a jobId — poll GET /cores/{id} until coreStatus is "ready".

    Responses

    • 202 — Accepted — taste generating
    • 400 — Validation failed, or an image could not be fetched
    • 401 — Missing, invalid or revoked key
    • 413 — Request body too large
    • 429 — Rate limited
    curl -X POST "https://api.mecore.ai/api/v1/org/cores" \
  -H "Authorization: Bearer $MECORE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"Summer looks","imageUrls":["https://cdn.example.com/1.jpg"]}'
    get
    /cores/{id}

    Get a core

    Parameters

    • id (path)

    Responses

    • 200 — The core and its generation status
    • 401 — Missing, invalid or revoked key
    • 404 — Not found, or belongs to another organization
    • 429 — Rate limited
    curl -X GET "https://api.mecore.ai/api/v1/org/cores/{id}" \
  -H "Authorization: Bearer $MECORE_API_KEY" \
  -H "Content-Type: application/json"
    patch
    /cores/{id}

    Rename a core or replace its images

    Replacing images starts a new taste job. A rename alone does not.

    Parameters

    • id (path)

    Responses

    • 200 — Updated
    • 400 — Validation failed, or an image could not be fetched
    • 401 — Missing, invalid or revoked key
    • 404 — Not found
    • 413 — Request body too large
    • 429 — Rate limited
    curl -X PATCH "https://api.mecore.ai/api/v1/org/cores/{id}" \
  -H "Authorization: Bearer $MECORE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"Winter looks"}'
    delete
    /cores/{id}

    Delete a core

    Parameters

    • id (path)

    Responses

    • 200 — Deleted
    • 401 — Missing, invalid or revoked key
    • 404 — Not found
    • 429 — Rate limited
    curl -X DELETE "https://api.mecore.ai/api/v1/org/cores/{id}" \
  -H "Authorization: Bearer $MECORE_API_KEY" \
  -H "Content-Type: application/json"
    get
    /jobs/{jobId}

    Poll a taste generation job

    Parameters

    • jobId (path)

    Responses

    • 200 — Job state — jobStatus is processing, ready or failed
    • 401 — Missing, invalid or revoked key
    • 404 — Not found
    • 429 — Rate limited
    curl -X GET "https://api.mecore.ai/api/v1/org/jobs/{jobId}" \
  -H "Authorization: Bearer $MECORE_API_KEY" \
  -H "Content-Type: application/json"