---
title: "Classify image at public url"
method: POST
path: "/api/v1/classify/image/url"
tags: ["classification"]
---

# Classify image at public url

`POST /api/v1/classify/image/url`

Classify an image downloadable via a public url for specific concepts or all concepts within a dataset

## Query parameters

- `threshold` number, double

## Headers

- `Authorization` string, required

## Request body

- PublicUrlClassificationRequest — A request to classify a publicly downloadable image for specific concepts or all concepts for a dataset. Either concept ids of a dataset id must be provided.
  - `url` string, required — A public url for downloading the image
  - `conceptIds` string[], nullable — The ids of concepts to use to classify an image
  - `datasetId` string, uuid4, nullable — The id of the dataset related to the concepts to use to classify an image

## Response `200`

Result of the classification

- Classification — A classification of an asset for one or more concepts
  - `scores` ClassificationScore[], required — Classifications of images for the relevant concept(s)
    - `conceptName` string, required — The concept name
    - `conceptId` string, uuid4, required — The concept id
    - `threshold` number, double, required — The threshold used to determine if it's a positive example
    - `positive` boolean, required — If the sample is classified as positive
    - `score` number, double, required — The classification score in the range [0, 1]

## Other responses

- `404` — Dataset not found
- `422` — Validation Error

---

[API](https://skmtc.dev/coactive/apis/api-reference.md) · [All operations](https://skmtc.dev/coactive/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/coactive/api-reference/revisions/1223758be9ba/schema)