{"swagger":"2.0","info":{"title":"atlas-tags","version":"0.0.1"},"consumes":["application/json"],"produces":["application/json"],"paths":{"/healthChecks":{"get":{"parameters":[],"responses":{"200":{"description":"Success.","schema":{"$ref":"#/definitions/healthCheck"}}}}},"/tags":{"post":{"parameters":[{"name":"tag_form","in":"body","schema":{"$ref":"#/definitions/tag_form"}}],"responses":{"201":{"description":"Created.","schema":{"$ref":"#/definitions/tag"}},"400":{"description":"Bad Request.","schema":{"$ref":"#/definitions/org.bml.validation.v0.models.fieldValidationResponse"}},"409":{"description":"Conflict. IE: the resource already exists. We return the existing tag so you can use it if you want to.","schema":{"$ref":"#/definitions/tag"}}}}},"/tags/{tagId}":{"get":{"parameters":[{"name":"tagId","in":"path","description":"A Tag resource id.","required":true,"type":"string","format":"uuid"}],"responses":{"200":{"description":"Success.","schema":{"$ref":"#/definitions/tag"}},"400":{"description":"Bad Request.","schema":{"$ref":"#/definitions/org.bml.validation.v0.models.fieldValidationResponse"}},"404":{"description":"Not Found."}}}},"/tags/{tagId}/objects":{"get":{"description":"Access to the object set of a Tag, provides basic slice type cursor access.","parameters":[{"name":"tagId","in":"path","description":"A Tag resource id","required":true,"maximum":255,"minimum":1,"type":"string"},{"name":"number","in":"query","description":"The number of the Slice you want","required":true,"default":"0","maximum":2147483646,"minimum":0,"type":"integer","format":"int32"},{"name":"size","in":"query","description":"The size of this Slice you want.","required":true,"maximum":500,"minimum":1,"type":"integer","format":"int32"},{"name":"objectSortField","in":"query","description":"The ObjectSortField you wish to sort on. NOTE: The only stable way to iterate through this list is by createdAt.","required":true,"maximum":500,"minimum":1},{"name":"sortOrder","in":"query","description":"The SortOrder used to order the overall set.","required":true,"maximum":500,"minimum":1}],"responses":{"200":{"description":"Success.","schema":{"$ref":"#/definitions/objectsSlice"}},"400":{"description":"Bad Request.","schema":{"$ref":"#/definitions/org.bml.validation.v0.models.fieldValidationResponse"}},"404":{"description":"Not Found."}}}}},"definitions":{"healthCheck":{"type":"object","description":"A response model for the standard health check resource.","title":"healthCheck","required":["health","status"],"properties":{"health":{"type":"string","enum":["HEALTHY","UNHEALTHY"]},"status":{"type":"string","enum":["STARTING_UP","RUNNING","SHUTTING_DOWN"]}}},"objectId":{"type":"object","description":"Encapsulates an Object UUID Id.","title":"objectId","required":["id","externalId"],"properties":{"id":{"description":"The tag services guid for this ObjectId.","type":"string","format":"uuid"},"externalId":{"description":"The external caller systems resource id for this Object.","type":"string","format":"uuid"},"description":{"description":"A short description of this object.","maximum":256,"minimum":0,"type":"string"}}},"objectsSlice":{"type":"object","description":"A slice of a set of objects.","title":"objectsSlice","required":["slice","objects"],"properties":{"slice":{"$ref":"#/definitions/slice"},"objects":{"type":"array","items":{"$ref":"#/definitions/objectId"}}}},"slice":{"type":"object","description":"An cursor Slice for iterating through sets.","title":"slice","required":["number","numberOfElements","size","hasContent","hasNext","hasPrevious","isFirst","isLast"],"properties":{"number":{"description":"The number of the current Slice.","type":"integer","format":"int32"},"numberOfElements":{"description":"The number of elements currently on this Slice.","type":"integer","format":"int32"},"size":{"description":"The size of this Slice.","type":"integer","format":"int32"},"hasContent":{"description":"Is there any content for this Slice.","type":"boolean"},"hasNext":{"description":"Is there is a next Slice.","type":"boolean"},"hasPrevious":{"description":"Is there is a previous Slice.","type":"boolean"},"isFirst":{"description":"Is this the first Slice.","type":"boolean"},"isLast":{"description":"Is this the last Slice.","type":"boolean"}}},"sortField":{"type":"object","description":"A field and an order used to sort sets.","title":"sortField","required":["field","order"],"properties":{"field":{"type":"string","enum":["name","createdAt","updatedAt"]},"order":{"type":"string","enum":["asc","desc"]}}},"tag":{"type":"object","description":"A tag.","title":"tag","required":["id","value"],"properties":{"id":{"description":"A UUID string for this tag.","type":"string","format":"uuid"},"value":{"description":"The tag value","maximum":512,"minimum":1,"example":"v0.0.1","type":"string"}}},"tag_form":{"type":"object","description":"A form for creating a tag object.","title":"tag_form","required":["value"],"properties":{"value":{"description":"The tag value","maximum":512,"minimum":1,"example":"v0.0.1","type":"string"}}}}}